OracleCommand.CommandText Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property CommandText As StringPublic Overrides Property CommandText As StringEigenschaftswert
Die SQL-Anweisung oder gespeicherte Prozedur, die ausgeführt werden soll. Der Standardwert ist eine leere Zeichenfolge ("").
Implementiert
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.
