OracleCommand.CommandText Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

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

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
public string CommandText { get; set; }
public override string CommandText { get; set; }
member this.CommandText : string with get, set
Public Property CommandText As String
Public Overrides 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

Beispiele

Im folgenden Beispiel wird ein OracleCommand erstellt und einige seiner Eigenschaften festgelegt.

public void CreateOracleCommand()
{
   OracleCommand command = new OracleCommand();
   command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo";
   command.CommandType = CommandType.Text;
}

Public Sub CreateOracleCommand()
    Dim command As New OracleCommand()
    command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo"
    command.CommandType = CommandType.Text
End Sub

Hinweise

Wenn die CommandType -Eigenschaft auf StoredProcedurefestgelegt ist, sollte die CommandText -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. Diese gespeicherte Prozedur wird vom Befehl ausgeführt, wenn Sie eine der Execute-Methoden aufrufen.

Der .NET Framework-Datenanbieter für Oracle unterstützt den Fragezeichenplatzhalter (?) nicht zum Übergeben von Parametern an eine SQL-Anweisung, die CommandType.Textvon aufgerufen wirdOracleCommand. In diesem Fall müssen benannte Parameter verwendet werden. Beispiel:

SELECT * FROM Customers WHERE CustomerID = :pCustomerID

Wenn Sie benannte Parameter in einer SQL-Anweisung verwenden, die CommandType.Textvon aufgerufen wirdOracleCommand, müssen Sie dem Parameternamen einen Doppelpunkt (:). In einer gespeicherten Prozedur oder beim Verweisen auf einen benannten Parameter an einer anderen Stelle im Code (z. B. beim Hinzufügen von OracleParameter Objekten zur Parameters -Eigenschaft) müssen Sie dem benannten Parameter jedoch keinen Doppelpunkt vorangestellt (:). Der .NET Framework-Datenanbieter für Oracle stellt den Doppelpunkt automatisch bereit.

Gilt für:

Weitere Informationen