OleDbCommand.CommandText Eigenschaft

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Assembly:

System.Data.dll

Ruft die SQL-Anweisung oder gespeicherte Prozedur ab, die für die Datenquelle ausgeführt werden soll, oder legt diese fest.

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

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

public override string CommandText { get; set; }

[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }

member this.CommandText : string with get, set

[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set

Public Overrides Property CommandText As String

Public Property CommandText As String

Eigenschaftswert

String

Die SQL-Anweisung oder gespeicherte Prozedur, die ausgeführt werden soll. Der Standardwert ist eine leere Zeichenfolge.

Implementiert

CommandText

Attribute

DataSysDescriptionAttribute

Beispiele

Im folgenden Beispiel wird ein OleDbCommand teil seiner Eigenschaften erstellt und festgelegt.

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}

Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

Hinweise

Wenn die Eigenschaft auf StoredProcedure"Festgelegt" festgelegt ist, sollte die CommandType CommandType Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Der Benutzer muss möglicherweise Escapezeichensyntax verwenden, wenn der name der gespeicherten Prozedur alle Sonderzeichen enthält. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie eine der Execute Methoden aufrufen.

Wenn CommandType sie TableDirectfestgelegt ist, sollte die CommandType Eigenschaft auf den Namen der Tabelle oder Tabellen festgelegt werden, auf die zugegriffen werden soll. Der Benutzer muss möglicherweise Escapezeichensyntax verwenden, wenn eine der benannten Tabellen Sonderzeichen enthält. Alle Zeilen und Spalten der benannten Tabelle oder Tabellen werden zurückgegeben, wenn Sie eine der Execute Methoden aufrufen.

Sie können die ConnectionEigenschaften CommandTypeund CommandText Eigenschaften nicht festlegen, wenn die aktuelle Verbindung einen Ausführungs- oder Abrufvorgang ausführt.

Der OLE-DB.NET-Anbieter unterstützt keine benannten Parameter zum Übergeben von Parametern an eine SQL-Anweisung oder eine gespeicherte Prozedur, die von einem Zeitpunkt aufgerufen wird, CommandType auf Textden OleDbCommand festgelegt wird. In diesem Fall muss der Fragezeichenplatzhalter (?) verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = ?

Daher muss die Reihenfolge, in OleDbParameter der Objekte dem OleDbParameterCollection Parameter hinzugefügt werden, direkt der Position des Fragezeichenplatzhalters für den Parameter entsprechen.

Weitere Informationen finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.

Siehe auch

• Arbeiten mit Befehlen