OleDbCommand.CommandText Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Paket:
System.Data.OleDb v9.0.0
Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs
Quelle:
OleDbCommand.cs

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 erstellt und einige seiner Eigenschaften 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 CommandType -Eigenschaft auf StoredProcedurefestgelegt ist, sollte die CommandType -Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Der Benutzer muss möglicherweise Escapezeichensyntax verwenden, wenn der Name der gespeicherten Prozedur Sonderzeichen enthält. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie eine der Execute Methoden aufrufen.

Wenn CommandType auf TableDirectfestgelegt ist, sollte die CommandType -Eigenschaft auf den Namen der Tabelle oder der 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 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 OleDbCommand aufgerufen wird, wenn CommandType auf Textfestgelegt ist. In diesem Fall muss der Fragezeichenplatzhalter (?) verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = ?

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

Weitere Informationen finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.

Gilt für:

Weitere Informationen