OracleCommand.CommandText-Eigenschaft
Ruft die SQL-Anweisung oder gespeicherte Prozedur ab, die für die Datenbank ausgeführt werden soll, oder legt diese fest.
Namespace: System.Data.OracleClient
Assembly: System.Data.OracleClient (in system.data.oracleclient.dll)
Syntax
'Declaration
Public Overrides Property CommandText As String
'Usage
Dim instance As OracleCommand
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 CommandText-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.
Der .NET Framework-Datenanbieter für Oracle unterstützt keinen Fragezeichenplatzhalter (?) beim Übergeben von Parametern an eine SQL-Anweisung, die durch einen OracleCommand von CommandType.Text aufgerufen wird. 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 durch einen OracleCommand von CommandType.Text aufgerufen wird, müssen Sie vor dem Parameternamen einen Doppelpunkt (:) einfügen. In einer gespeicherten Prozedur oder bei Verweisen auf einen benannten Parameter an einer anderer Stelle im Code (wenn z. B. der Parameters-Eigenschaft OracleParameter-Objekte hinzugefügt werden) darf vor dem benannten Parameter jedoch kein Doppelpunkt (:) eingefügt werden. Der .NET Framework-Datenanbieter für Oracle stellt den Doppelpunkt automatisch bereit.
Beispiel
Im folgenden Beispiel wird ein OracleCommand erstellt, und einige seiner Eigenschaften werden festgelegt.
Public Sub CreateOracleCommand()
Dim command As New OracleCommand()
command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo"
command.CommandType = CommandType.Text
End Sub
public void CreateOracleCommand()
{
OracleCommand command = new OracleCommand();
command.CommandText = "SELECT * FROM Emp ORDER BY EmpNo";
command.CommandType = CommandType.Text;
}
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
Siehe auch
Referenz
OracleCommand-Klasse
OracleCommand-Member
System.Data.OracleClient-Namespace