SqlCommand.CommandText Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

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 Jazyka Transact-SQL nebo uložená procedura, která se má provést. Výchozí hodnota je prázdný řetězec.

Příklady

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

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

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

}

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