SqlCommand.CommandText Eigenschaft

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

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 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

String

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

Implementiert

CommandText

Attribute: DataSysDescriptionAttribute

Beispiele

Im folgenden Beispiel wird eine SqlCommand Reihe seiner Eigenschaften erstellt und 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 Eigenschaft auf StoredProcedure"Festgelegt" festgelegt ist, sollte die CommandType CommandText Eigenschaft auf den Namen der gespeicherten Prozedur festgelegt werden. Der Benutzer muss möglicherweise die Escapezeichensyntax verwenden, wenn der gespeicherte Prozedurname spezielle Zeichen 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 nicht den Fragezeichenplatzhalter (?) für das Übergeben von Parametern an eine Transact-SQL-Anweisung oder eine gespeicherte Prozedur, die von einem Befehl 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: