SqlCommand.CommandText Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает инструкцию Transact-SQL, имя таблицы или хранимую процедуру, выполняемую для источника данных.

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

Значение свойства

String

Выполняемые инструкция Transact-SQL или хранимая процедура. Значение по умолчанию - пустая строка.

Примеры

В следующем примере создается SqlCommand и задаются некоторые его свойства.

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

}

Комментарии

Если свойству CommandType присвоено значение StoredProcedure, свойству CommandText должно быть присвоено имя хранимой процедуры. Пользователю может потребоваться использовать синтаксис escape-символов, если имя хранимой процедуры содержит специальные символы. Команда выполняет эту хранимую процедуру при вызове Execute одного из методов .

Поставщик данных Microsoft платформа .NET Framework для SQL Server не поддерживает заполнитель вопросительного знака (?) для передачи параметров в инструкцию Transact-SQL или хранимую процедуру, вызываемую командой CommandType.Text. В этом случае необходимо использовать именованные параметры. Пример:

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Дополнительные сведения см. в разделе Настройка параметров.