SqlCommand.CommandText Vlastnost

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

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 override string CommandText { get; set; }

member this.CommandText : string with get, set

Public Overrides Property CommandText As String

Hodnota vlastnosti

String

Příkaz Transact-SQL nebo uložená procedura ke spuštění. Výchozí hodnota je prázdný řetězec.

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 na StoredProcedure, CommandText vlastnost by měla být nastavena na název uložené procedury. Pokud název uložené procedury obsahuje speciální znaky, může být nutné použít syntaxi řídicích znaků. Příkaz spustí tuto uloženou proceduru Execute při volání jedné z 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 Transact-SQL nebo uložené procedury volané příkazem CommandType.Text. V tomto případě se musí použít pojmenované parametry. Například:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

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

Viz také

• Načítání a úpravy dat v ADO.NET
• SQL Server a ADO.NET
• Přehled ADO.NET