Поделиться через

SqlCommand.CommandText Свойство

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

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

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

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

String

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

Реализации

CommandText
Атрибуты
DataSysDescriptionAttribute

Примеры

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

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

Комментарии

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

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

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

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

Применяется к

См. также раздел