Freigeben über

SqlCeCommand-Klasse

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

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

Eine Liste aller Member dieses Typs finden Sie unter SqlCeCommand-Member.

System.Object
   System.MarshalByRefObject
      System.Data.SqlServerCe.SqlCeCommand

NotInheritable Public Class SqlCeCommand
   Inherits MarshalByRefObject
   Implements ICloneable, IDbCommand, IDisposable
[C#]
public sealed class SqlCeCommand : MarshalByRefObject, ICloneable,
   IDbCommand, IDisposable
[C++]
public __gc __sealed class SqlCeCommand : public
   MarshalByRefObject, ICloneable, IDbCommand, IDisposable
[JScript]
public class SqlCeCommand extends MarshalByRefObject implements
   ICloneable, IDbCommand, IDisposable

Threadsicherheit

Alle öffentlichen statischen Member (Shared in Visual Basic) dieses Typs sind für Multithreadvorgänge sicher. Es wird nicht garantiert, dass alle Instanzenmember threadsicher sind.

Hinweise

Wenn eine Instanz von SqlCeCommand erstellt wird, werden die Lese-/Schreibeigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter 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.

Wenn CommandType auf Text festgelegt ist, unterstützt der .NET Compact Framework-Datenprovider für SQL Server CE keine benannten Parameter, mit denen Parameter an eine SQL-Anweisung übergeben werden, die von SqlCeCommand aufgerufen wird. Als Platzhalter muss ein Fragezeichen (?) verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = ?

Die Reihenfolge, in der SqlCeParameter-Objekte der SqlCeParameterCollection hinzugefügt werden, muss der Position des Fragezeichenplatzhalters für den Parameter entsprechen.

Der Datenprovider für SQL Server CE unterstützt außerdem keine Stapelabfragen. Befehle müssen in der Form Select * from Customers und nicht Select * from Customers; Select *

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

Obwohl SQL Server CE nur eine Verbindung gleichzeitig unterstützt, können mehrere Befehle dieselbe Verbindung gemeinsam verwenden. Daher können bei derselben Verbindung mehrere Instanzen von SqlCeDataReader vorkommen. Dieses Verhalten unterscheidet sich von dem von System.Data.SqlClient.

Wenn eine schwerwiegende SqlCeException 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.

Anforderungen

Namespace: System.Data.SqlServerCe

Plattformen: .NET Compact Framework - Windows CE .NET

Assembly: System.Data.Sqlserverce (in der Datei System.Data.Sqlserverce.dll)

Siehe auch

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

  • Last updated on