SqlCeCommand-Klasse

Artikel
01/17/2011

Stellt eine SQL-Anweisung dar, die für eine Datenquelle ausgeführt werden soll.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
Public NotInheritable Class SqlCeCommand _
    Inherits DbCommand _
    Implements ICloneable
'Usage
Dim instance As SqlCeCommand

public sealed class SqlCeCommand : DbCommand, 
    ICloneable

public ref class SqlCeCommand sealed : public DbCommand, 
    ICloneable

[<SealedAttribute>]
type SqlCeCommand =  
    class
        inherit DbCommand
        interface ICloneable
    end

public final class SqlCeCommand extends DbCommand implements ICloneable

Hinweise

Wenn eine Instanz der SqlCeCommand-Klasse erstellt wird, werden die Lese-/Schreibeigenschaften auf ihre Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter dem SqlCeCommand-Konstruktor.

Die SqlCeCommand-Klasse enthält die folgenden Methoden, die Befehle in einer Datenquelle ausführen:

Element	Beschreibung
ExecuteReader	Führt Befehle aus, die Zeilen zurückgeben.
ExecuteNonQuery	Führt SQL-Befehle wie die Anweisungen INSERT, DELETE und UPDATE aus.
ExecuteScalar	Ruft einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank ab.
ExecuteResultSet	Führt Befehle aus und gibt Ergebnisse zurück.

Der Datenanbieter für SQL Server Compact 3.5 unterstützt keine Stapelabfragen. Befehle müssen das folgende Format aufweisen:

Select * from Customers und nicht Select * from Customers; Select * from Orders;

Wenn Sie Code verwenden, der für den System.Data.SqlClient-Namespace generiert wurde, müssen Sie u. U. die Abfragen so ändern, dass sie dieser Einschränkung entsprechen.

SQL Server Compact 3.5 unterstützt sowohl mehrere gleichzeitige Verbindungen als auch Verbindungen, die von mehreren Befehlen gleichzeitig verwendet werden. Daher können bei derselben Verbindung mehrere Instanzen der SqlCeDataReader-Klasse vorkommen. Dieses Verhalten unterscheidet sich von dem des System.Data.SqlClient-Namespace.

Wenn eine schwerwiegende SqlCeException-Ausnahme durch die Methode ausgelöst wird, die eine SqlCeCommand-Klasse ausführt, wird die SqlCeConnection-Klasse möglicherweise geschlossen. Sie können die Verbindung aber erneut öffnen und fortfahren.

Beispiele

Im folgenden Beispiel wird die SqlCeCommand-Klasse zusammen mit der SqlCeConnection-Klasse zum Auswählen von Zeilen aus einer Datenbank verwendet.

Dim query As String = "SELECT [Order ID], [Customer] FROM Orders"
Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand(query, conn)

conn.Open()
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()

Try
    ' Iterate through the results
    '
    While rdr.Read()
        Dim val1 As Integer = rdr.GetInt32(0)
        Dim val2 As String = rdr.GetString(1)
    End While
Finally
    ' Always call Close when done reading
    '
    rdr.Close()

    ' Always call Close when done reading
    '
    conn.Close()
End Try

string query = "SELECT [Order ID], [Customer] FROM Orders";
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand(query, conn);

conn.Open();
SqlCeDataReader rdr = cmd.ExecuteReader();

try
{
    // Iterate through the results
    //
    while (rdr.Read())
    {
        int val1 = rdr.GetInt32(0);
        string val2 = rdr.GetString(1);
    }
}
finally
{
    // Always call Close when done reading
    //
    rdr.Close();

    // Always call Close when done reading
    //
    conn.Close();
}