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


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

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

Инструкция или хранимая процедура 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 одного из методов .

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

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

SELECT * FROM Customers WHERE CustomerID = ?

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

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

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

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