OleDbCommand.CommandText Свойство

Определение

Возвращает или задает оператор 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

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

Реализации

Атрибуты

Примеры

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

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

Комментарии

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

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

Нельзя задать ConnectionCommandTypeCommandText и свойства, если текущее соединение выполняет операцию выполнения или получения.

Поставщик OLE DB.NET не поддерживает именованные параметры для передачи параметров в инструкцию SQL или хранимую процедуру, вызываемую параметром when OleDbCommand CommandType is set.Text В этом случае необходимо использовать заполнитель вопросительного знака (?). Пример:

SELECT * FROM Customers WHERE CustomerID = ?

Таким образом, порядок OleDbParameter добавления объектов в OleDbParameterCollection объект должен напрямую соответствовать положению заполнителя вопросительного знака для параметра.

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

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

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