OleDbCommand.CommandText-Eigenschaft

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

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

Syntax

'Declaration
Public Overrides Property CommandText As String
'Usage
Dim instance As OleDbCommand
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 gespeicherte Prozedur. Der Standardwert ist eine leere Zeichenfolge.

Hinweise

Wenn die CommandType-Eigenschaft auf StoredProcedure festgelegt ist, muss die CommandType-Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Möglicherweise müssen die Benutzer die 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 TableDirect festgelegt ist, muss die CommandType-Eigenschaft auf den Namen der Tabelle(n) festgelegt werden, auf die zugegriffen werden soll. Möglicherweise müssen die Benutzer 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 Ausführungs- oder Abrufoperation ausführt.

Der OLE DB-.NET-Anbieter unterstützt keine benannten Parameter für die Übergabe von Parametern an eine SQL-Anweisung oder gespeicherte Prozedur, die von OleDbCommand aufgerufen wird, wenn CommandType auf Text festgelegt ist. In diesem Fall muss das Fragezeichen (?) als Platzhalter verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = ?

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

Weitere Informationen finden Sie unter Verwenden von gespeicherten Prozeduren mit einem Befehl.

Beispiel

Im folgenden Beispiel wird ein OleDbCommand erstellt, und einige seiner Eigenschaften werden festgelegt.

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

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

OleDbCommand-Klasse
OleDbCommand-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen