SqlCommand.CommandText Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

Získá nebo nastaví Transact-SQL příkaz, název tabulky nebo uložená procedura ke spuštění ve zdroji dat.

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

Hodnota vlastnosti

String

Příkaz Jazyka Transact-SQL nebo uložená procedura, která se má provést. Výchozí hodnota je prázdný řetězec.

Implementuje

CommandText
Atributy
DataSysDescriptionAttribute

Příklady

Následující příklad vytvoří SqlCommand a nastaví některé jeho vlastnosti.

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

Poznámky

CommandType Pokud je vlastnost nastavena CommandText na StoredProcedurehodnotu , měla by být vlastnost nastavena na název uložené procedury. Pokud název uložené procedury obsahuje nějaké speciální znaky, může být nutné, aby uživatel použil syntaxi řídicího znaku. Příkaz spustí tuto uloženou proceduru při volání jedné z Execute metod.

Zprostředkovatel dat rozhraní Microsoft .NET Framework pro SQL Server nepodporuje zástupný symbol otazníku (?) pro předávání parametrů do příkazu jazyka Transact-SQL nebo uložené procedury volané příkazem .CommandType.Text V tomto případě je nutné použít pojmenované parametry. Příklad:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Další informace najdete v tématu Konfigurace parametrů a datových typů parametrů.

Platí pro

Viz také