SqlCeCommand.CommandText-Eigenschaft

Artikel
08/20/2007

Ruft eine SQL-Anweisung ab, die in der Datenquelle ausgeführt wird, oder legt diese fest.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Overrides Property CommandText As String
'Usage
Dim instance As SqlCeCommand
Dim value As String

value = instance.CommandText

instance.CommandText = value

public override string CommandText { get; set; }

public:
virtual property String^ CommandText {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_CommandText ()

/** @property */
public void set_CommandText (String value)

public override function get CommandText () : String

public override function set CommandText (value : String)

Eigenschaftenwert

Die auszuführende SQL-Anweisung oder der Name der zu öffnenden Basistabelle. Der Standardwert ist eine leere Zeichenfolge.

Hinweise

Wenn die CommandType-Eigenschaft auf TableDirect festgelegt ist, muss die CommandText-Eigenschaft auf den Namen der Tabelle festgelegt werden, auf die zugegriffen wird. TableDirect-Zugriff stellt die schnellste Möglichkeit dar, Daten von SQL Server Mobile abzurufen. Möglicherweise müssen Sie die Escapezeichensyntax verwenden, wenn eine der benannten Tabellen Sonderzeichen enthält. Beim Aufruf einer der Execute-Methoden werden sämtliche Zeilen und Spalten der benannten Tabelle(n) zurückgegeben.

Die Eigenschaften Connection, CommandType und CommandText können nicht festgelegt werden, wenn die aktuelle Verbindung eine Execute- oder Fetch-Operation ausführt.

Wenn die CommandType-Eigenschaft auf Text festgelegt ist, unterstützt der .NET Compact Framework-Datenanbieter für SQL Server Mobile benannte Parameter, mit denen Parameter an eine SQL-Anweisung übergeben werden, die von einer SqlCeCommand-Klasse aufgerufen wird. Beispiel:

SELECT * FROM Customers WHERE CustomerID = @customerID

Der Datenanbieter für SQL Server Mobile unterstützt zudem keine Stapelabfragen. Befehle müssen im folgenden Format vorliegen: 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.

Beispiel

Im folgenden Beispiel wird eine SqlCeCommand-Klasse erstellt, und es werden die CommandText-Eigenschaft und andere Eigenschaften festgelegt.

Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
cmd.CommandType = CommandType.Text
cmd.UpdatedRowSource = UpdateRowSource.Both

SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
cmd.CommandType = CommandType.Text;
cmd.UpdatedRowSource = UpdateRowSource.Both;

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

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-Klasse
SqlCeCommand-Member
System.Data.SqlServerCe-Namespace
Connection
IDbCommand.CommandType-Eigenschaft

Freigeben über