SqlCeCommand.CommandText-Eigenschaft
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
Get
Set
'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;
}
abstract CommandText : string with get, set
override CommandText : string with get, set
override function get CommandText () : String
override function set CommandText (value : String)
Eigenschaftswert
Typ: System.String
Die auszuführende SQL-Anweisung oder der Name der zu öffnenden Basistabelle. Der Standardwert ist eine leere Zeichenfolge.
Implementiert
Hinweise
Wenn die CommandType-Eigenschaft auf TableDirect festgelegt ist, muss die CommandText-Eigenschaft auf den Namen der Tabelle festgelegt werden, auf die zugegriffen werden soll. TableDirect-Zugriff stellt die schnellste Möglichkeit dar, Daten von SQL Server Compact 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 CommandType auf Text festgelegt ist, unterstützt der .NET Compact Framework-Datenanbieter für SQL Server Compact benannte Parameter, mit denen Parameter an eine SQL-Anweisung übergeben werden, die von einem SqlCeCommand aufgerufen wird. Beispiel:
SELECT * FROM Customers WHERE CustomerID = @customerID
Der Datenanbieter für SQL Server Compact unterstützt 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.
Geben Sie Spaltennamen für INSERT-Abfragen an, wenn Sie die Replikation mit aktiviertem Remotedatenzugriff verwenden. RDA-nachverfolgte Tabellen enthalten systemgenerierte Spalten, wodurch sich die Anzahl der Spalten ändert, sodass sie möglicherweise nicht mehr der für die Abfrage erwarteten entspricht. Wenn Sie keine Spaltennamen angeben und sich die Anzahl der Spalten in der INSERT-Anweisung von der Anzahl der Spalten in der Tabelle unterscheidet, führt INSERT zu einem Fehler.
Beispiele
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;