Freigeben über


SqlCeCommand-Klasse

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

Vererbungshierarchie

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

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

Der SqlCeCommand-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode SqlCeCommand() Initialisiert eine neue Instanz der SqlCeCommand-Klasse.
Öffentliche Methode SqlCeCommand(String) Initialisiert eine neue Instanz der SqlCeCommand-Klasse mit dem Text der Abfrage.
Öffentliche Methode SqlCeCommand(String, SqlCeConnection) Initialisiert eine neue Instanz der SqlCeCommand-Klasse mit dem Text der Abfrage und einer SqlCeConnection-Klasse.
Öffentliche Methode SqlCeCommand(String, SqlCeConnection, SqlCeTransaction) Initialisiert eine neue Instanz der SqlCeCommand-Klasse mit dem Text der Abfrage, einer SqlCeConnection-Klasse und der SqlCeTransaction-Klasse.

Zum Anfang

Eigenschaften

  Name Beschreibung
Geschützte Eigenschaft CanRaiseEvents (von Component vererbt)
Öffentliche Eigenschaft CommandText Ruft eine SQL-Anweisung ab, die in der Datenquelle ausgeführt wird, oder legt diese fest. (Überschreibt DbCommand.CommandText.)
Öffentliche Eigenschaft CommandTimeout Ruft die Zeit ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest. (Überschreibt DbCommand.CommandTimeout.)
Öffentliche Eigenschaft CommandType Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen fest. (Überschreibt DbCommand.CommandType.)
Öffentliche Eigenschaft Connection Ruft die SqlCeConnection-Klasse ab, die von dieser Instanz der SqlCeCommand-Klasse verwendet wird, oder legt diese fest.
Öffentliche Eigenschaft Container (von Component vererbt)
Geschützte Eigenschaft DbConnection (von DbCommand vererbt)
Geschützte Eigenschaft DbParameterCollection (von DbCommand vererbt)
Geschützte Eigenschaft DbTransaction (von DbCommand vererbt)
Geschützte Eigenschaft DesignMode (von Component vererbt)
Öffentliche Eigenschaft DesignTimeVisible "Get" gibt immer "false" zurück, "set" löst immer eine NotSupportedException-Ausnahme aus. (Überschreibt DbCommand.DesignTimeVisible.)
Geschützte Eigenschaft Events (von Component vererbt)
Öffentliche Eigenschaft IndexName Gibt den zu öffnenden Index an.
Öffentliche Eigenschaft Parameters Ruft die SqlCeParameterCollection-Klasse ab.
Öffentliche Eigenschaft Site (von Component vererbt)
Öffentliche Eigenschaft Transaction Ruft die Transaktion ab, in der die SqlCeCommand-Klasse ausgeführt wird, oder legt diese fest.
Öffentliche Eigenschaft UpdatedRowSource Ruft ab oder legt fest, wie die Ergebnisse von Befehlen auf die DataRow-Klasse angewendet werden, wenn diese von der Update-Methode der DbDataAdapter-Klasse verwendet wird. Diese Eigenschaft darf nicht mit dem .NET Compact Framework-Datenanbieter für SQL Server Compact verwendet werden. (Überschreibt DbCommand.UpdatedRowSource.)

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Cancel Versucht die Ausführung einer SqlCeCommand-Klasse abzubrechen. (Überschreibt DbCommand.Cancel().)
Geschützte Methode CreateDbParameter (von DbCommand vererbt)
Öffentliche Methode CreateObjRef (von MarshalByRefObject vererbt)
Öffentliche Methode CreateParameter Erstellt eine neue Instanz eines SqlCeParameter-Objekts.
Öffentliche Methode Dispose() (von Component vererbt)
Geschützte Methode Dispose(Boolean) (von Component vererbt)
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode ExecuteDbDataReader (von DbCommand vererbt)
Öffentliche Methode ExecuteNonQuery Führt eine SQL-Anweisung für die SqlCeConnection-Klasse aus und gibt die Anzahl der betroffenen Zeilen zurück. (Überschreibt DbCommand.ExecuteNonQuery().)
Öffentliche Methode ExecuteReader() Sendet die CommandText-Eigenschaft an die Connection-Klasse und erstellt eine SqlCeDataReader-Klasse.
Öffentliche Methode ExecuteReader(CommandBehavior) Sendet die CommandText-Eigenschaft an die Connection-Klasse und erstellt eine SqlCeDataReader-Klasse mit einem der CommandBehavior-Werte.
Öffentliche Methode ExecuteResultSet(ResultSetOptions) Sendet die CommandText-Eigenschaft an die Connection-Eigenschaft und erstellt eine SqlCeResultSet-Klasse unter Verwendung der ResultSetOptions-Enumeration.
Öffentliche Methode ExecuteResultSet(ResultSetOptions, SqlCeResultSet) Sendet die CommandText-Eigenschaft an die Connection-Eigenschaft und erstellt eine SqlCeResultSet-Klasse unter Verwendung der ResultSetOptions-Enumeration.
Öffentliche Methode ExecuteScalar Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert. (Überschreibt DbCommand.ExecuteScalar().)
Geschützte Methode Finalize (von Component vererbt)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode GetService (von Component vererbt)
Öffentliche Methode GetType (von Object vererbt)
Öffentliche Methode InitializeLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode MemberwiseClone() (von Object vererbt)
Geschützte Methode MemberwiseClone(Boolean) (von MarshalByRefObject vererbt)
Öffentliche Methode Prepare Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle. (Überschreibt DbCommand.Prepare().)
Öffentliche Methode SetRange Schränkt die Menge der Zeilen ein, die vom SqlCeDataReader gelesen werden.
Öffentliche Methode ToString (von Component vererbt)

Zum Anfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis Disposed (von Component vererbt)

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Methode ICloneable.Clone
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbCommand.Connection (von DbCommand vererbt)
Explizite SchnittstellenimplementierungPrivate Methode IDbCommand.CreateParameter (von DbCommand vererbt)
Explizite SchnittstellenimplementierungPrivate Methode IDbCommand.ExecuteReader() (von DbCommand vererbt)
Explizite SchnittstellenimplementierungPrivate Methode IDbCommand.ExecuteReader(CommandBehavior) (von DbCommand vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbCommand.Parameters (von DbCommand vererbt)
Explizite SchnittstellenimplementierungPrivate Eigenschaft IDbCommand.Transaction (von DbCommand vererbt)

Zum Anfang

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.

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

Threadsicherheit

Alle öffentlichen statischen (in Microsoft Visual Basic freigegebenen) Elemente dieses Typs sind threadsicher. Für Instanzelemente kann nicht sichergestellt werden, dass sie threadsicher sind.

Siehe auch

Verweis

System.Data.SqlServerCe-Namespace

SqlCeDataAdapter

SqlCeConnection