SqlCommand.CommandText Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Pobiera lub ustawia instrukcję Języka Transact-SQL, nazwę tabeli lub procedurę składowaną do wykonania w źródle danych.

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

Wartość właściwości

String

Instrukcja Transact-SQL lub procedura składowana do wykonania. Wartość domyślna to pusty ciąg.

Przykłady

Poniższy przykład tworzy obiekt SqlCommand i ustawia niektóre z jego właściwości.

// <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>

}

Uwagi

CommandType Gdy właściwość jest ustawiona na StoredProcedurewartość , CommandText właściwość powinna być ustawiona na nazwę procedury składowanej. Użytkownik może być zobowiązany do używania składni znaków ucieczki, jeśli nazwa procedury składowanej zawiera jakiekolwiek znaki specjalne. Polecenie wykonuje tę procedurę składowaną podczas wywoływania Execute jednej z metod.

Dostawca danych microsoft .NET Framework dla SQL Server nie obsługuje symbolu zastępczego znaku zapytania (?) do przekazywania parametrów do instrukcji Języka Transact-SQL lub procedury składowanej wywoływanej CommandType.Textprzez polecenie . W takim przypadku należy użyć nazwanych parametrów. Przykład:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Aby uzyskać więcej informacji, zobacz Konfigurowanie parametrów.