Freigeben über

SqlCommand.CommandText Eigenschaft

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Quelle:
System.Data.SqlClient.notsupported.cs

Ruft die Transact-SQL-Anweisung, den Tabellennamen oder die gespeicherte Prozedur ab, die an der Datenquelle ausgeführt werden soll, oder legt diese 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 ein SqlCommand Teil 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 CommandType Eigenschaft auf " StoredProcedureFestgelegt" festgelegt 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 nicht den Fragezeichenplatzhalter (?), um Parameter an eine Transact-SQL-Anweisung oder eine gespeicherte Prozedur zu übergeben, die von einem Befehl aufgerufen CommandType.Textwird. 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