SqlCommand.CommandText-Eigenschaft

Ruft die Transact-SQL-Anweisung oder die gespeicherte Prozedur ab, die für die Datenquelle ausgeführt werden soll, oder legt diese fest.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Property CommandText As String
'Usage
Dim instance As SqlCommand
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 Transact-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.

Beim Übergeben von Parametern an eine Transact-SQL-Anweisung oder eine gespeicherte Prozedur, die durch einen CommandType.Text-Befehl aufgerufen wird, bietet der .NET Framework-Datenanbieter für SQL Server keine Unterstützung für Fragezeichenplatzhalter (?). In diesem Fall müssen benannte Parameter verwendet werden. Beispiel:

 SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Weitere Informationen finden Sie unter Verwenden von gespeicherten Prozeduren mit einem Befehl.

Beispiel

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

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 

public void CreateCommand() 
 {
    SqlCommand command = new SqlCommand();
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlCommand-Klasse
SqlCommand-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server