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
	SqlCeCommand()	Initialisiert eine neue Instanz der SqlCeCommand-Klasse.
	SqlCeCommand(String)	Initialisiert eine neue Instanz der SqlCeCommand-Klasse mit dem Text der Abfrage.
	SqlCeCommand(String, SqlCeConnection)	Initialisiert eine neue Instanz der SqlCeCommand-Klasse mit dem Text der Abfrage und einer SqlCeConnection-Klasse.
	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
	CanRaiseEvents	(von Component vererbt)
	CommandText	Ruft eine SQL-Anweisung ab, die in der Datenquelle ausgeführt wird, oder legt diese fest. (Überschreibt DbCommand.CommandText.)
	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.)
	CommandType	Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen fest. (Überschreibt DbCommand.CommandType.)
	Connection	Ruft die SqlCeConnection-Klasse ab, die von dieser Instanz der SqlCeCommand-Klasse verwendet wird, oder legt diese fest.
	Container	(von Component vererbt)
	DbConnection	(von DbCommand vererbt)
	DbParameterCollection	(von DbCommand vererbt)
	DbTransaction	(von DbCommand vererbt)
	DesignMode	(von Component vererbt)
	DesignTimeVisible	"Get" gibt immer "false" zurück, "set" löst immer eine NotSupportedException-Ausnahme aus. (Überschreibt DbCommand.DesignTimeVisible.)
	Events	(von Component vererbt)
	IndexName	Gibt den zu öffnenden Index an.
	Parameters	Ruft die SqlCeParameterCollection-Klasse ab.
	Site	(von Component vererbt)
	Transaction	Ruft die Transaktion ab, in der die SqlCeCommand-Klasse ausgeführt wird, oder legt diese fest.
	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
	Cancel	Versucht die Ausführung einer SqlCeCommand-Klasse abzubrechen. (Überschreibt DbCommand.Cancel().)
	CreateDbParameter	(von DbCommand vererbt)
	CreateObjRef	(von MarshalByRefObject vererbt)
	CreateParameter	Erstellt eine neue Instanz eines SqlCeParameter-Objekts.
	Dispose()	(von Component vererbt)
	Dispose(Boolean)	(von Component vererbt)
	Equals	(von Object vererbt)
	ExecuteDbDataReader	(von DbCommand vererbt)
	ExecuteNonQuery	Führt eine SQL-Anweisung für die SqlCeConnection-Klasse aus und gibt die Anzahl der betroffenen Zeilen zurück. (Überschreibt DbCommand.ExecuteNonQuery().)
	ExecuteReader()	Sendet die CommandText-Eigenschaft an die Connection-Klasse und erstellt eine SqlCeDataReader-Klasse.
	ExecuteReader(CommandBehavior)	Sendet die CommandText-Eigenschaft an die Connection-Klasse und erstellt eine SqlCeDataReader-Klasse mit einem der CommandBehavior-Werte.
	ExecuteResultSet(ResultSetOptions)	Sendet die CommandText-Eigenschaft an die Connection-Eigenschaft und erstellt eine SqlCeResultSet-Klasse unter Verwendung der ResultSetOptions-Enumeration.
	ExecuteResultSet(ResultSetOptions, SqlCeResultSet)	Sendet die CommandText-Eigenschaft an die Connection-Eigenschaft und erstellt eine SqlCeResultSet-Klasse unter Verwendung der ResultSetOptions-Enumeration.
	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().)
	Finalize	(von Component vererbt)
	GetHashCode	(von Object vererbt)
	GetLifetimeService	(von MarshalByRefObject vererbt)
	GetService	(von Component vererbt)
	GetType	(von Object vererbt)
	InitializeLifetimeService	(von MarshalByRefObject vererbt)
	MemberwiseClone()	(von Object vererbt)
	MemberwiseClone(Boolean)	(von MarshalByRefObject vererbt)
	Prepare	Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle. (Überschreibt DbCommand.Prepare().)
	SetRange	Schränkt die Menge der Zeilen ein, die vom SqlCeDataReader gelesen werden.
	ToString	(von Component vererbt)

Zum Anfang

Ereignisse

	Name	Beschreibung
	Disposed	(von Component vererbt)

Zum Anfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	ICloneable.Clone
	IDbCommand.Connection	(von DbCommand vererbt)
	IDbCommand.CreateParameter	(von DbCommand vererbt)
	IDbCommand.ExecuteReader()	(von DbCommand vererbt)
	IDbCommand.ExecuteReader(CommandBehavior)	(von DbCommand vererbt)
	IDbCommand.Parameters	(von DbCommand vererbt)
	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