SqlCeCommand-Klasse

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

public final class SqlCeCommand extends DbCommand implements ICloneable

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:

Der Datenanbieter für SQL Server Mobile 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 Mobile 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 einen SqlCeCommand ausführt, wird die SqlCeConnection möglicherweise geschlossen. Sie können die Verbindung aber erneut öffnen und fortfahren.

Beispiel

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();
}

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.SqlServerCe.SqlCeCommand

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlCeCommand-Member
System.Data.SqlServerCe-Namespace
SqlCeDataAdapter
SqlCeConnection