Freigeben über


SqlCommand.CommandText Eigenschaft

Definition

Ruft die Transact-SQL-Anweisung, den Tabellennamen oder die gespeicherte Prozedur ab, die oder der für die Datenquelle ausgeführt werden soll, oder legt diese(n) 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

Die auszuführende Transact-SQL-Anweisung oder gespeicherte Prozedur. Der Standardwert ist eine leere Zeichenfolge.

Implementiert

Attribute

Beispiele

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

public void CreateCommand()
 {
    SqlCommand command = new SqlCommand();
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }
Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    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. Der Befehl führt diese gespeicherte Prozedur aus, wenn Sie eine der Execute Methoden aufrufen.

Der Microsoft .NET Framework-Datenanbieter für SQL Server unterstützt den Fragezeichenplatzhalter (?) nicht zum Übergeben von Parametern an eine Transact-SQL-Anweisung oder eine gespeicherte Prozedur, die durch einen Befehl von CommandType.Textaufgerufen wird. In diesem Fall müssen benannte Parameter verwendet werden. Beispiel:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Weitere Informationen finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.

Gilt für:

Weitere Informationen