OleDbCommand.CommandText Свойство

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v8.0.0

Исходный код:

OleDbCommand.cs

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

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

Реализации

CommandText

Примеры

В следующем примере создается 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 одного из методов .

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

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

SELECT * FROM Customers WHERE CustomerID = ?

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

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

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

• Работа с командами