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
[<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 |
---|---|
Führt Befehle aus, die Zeilen zurückgeben. |
|
Führt SQL-Befehle wie die Anweisungen INSERT, DELETE und UPDATE aus. |
|
Ruft einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank ab. |
|
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();
}
Vererbungshierarchie
System. . :: . .Object
System. . :: . .MarshalByRefObject
System.ComponentModel. . :: . .Component
System.Data.Common. . :: . .DbCommand
System.Data.SqlServerCe..::..SqlCeCommand
Threadsicherheit
Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.