SqlCeCommand.CommandText-Eigenschaft

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

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

Public Overridable Property CommandText As String  Implements _   IDbCommand.CommandText
[C#]
public virtual string CommandText {get; set;}
[C++]
public: __property virtual String* get_CommandText();public: __property virtual void set_CommandText(String*);
[JScript]
public function get CommandText() : String;public function set CommandText(String);

Eigenschaftenwert

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

Implementiert

IDbCommand.CommandText

Hinweise

Wenn die CommandType-Eigenschaft auf TableDirect festgelegt wird, sollte 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 CE 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 Connection-Eigenschaft, die CommandType-Eigenschaft und die CommandText-Eigenschaft können nicht festgelegt werden, wenn die aktuelle Verbindung eine Execute- oder Fetch-Operation ausführt.

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 direkt entsprechen.

Der Datenprovider für SQL Server CE unterstützt außerdem keine Stapelabfragen. Befehle müssen in folgender Form vorliegen: SELECT * FROM Customers und nicht SELECT * FROM Customers; SELECT *

FROM Orders. 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.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.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 Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

SqlCeCommand-Klasse | SqlCeCommand-Member | System.Data.SqlServerCe-Namespace | Connection | CommandType