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

OleDbCommand.CommandText Свойство

Определение

Пространство имен:
System.Data.OleDb
Сборка:
System.Data.OleDb.dll
Сборка:
System.Data.dll
Пакет:
System.Data.OleDb v11.0.0-preview.2.26159.112
Исходный код:
OleDbCommand.cs
Исходный код:
OleDbCommand.cs
Исходный код:
OleDbCommand.cs
Исходный код:
OleDbCommand.cs

Возвращает или задает инструкцию 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 или хранимая процедура для выполнения. Значение по умолчанию: пустая строка.

Реализации

CommandText
Атрибуты
DataSysDescriptionAttribute

Примеры

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

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

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

SELECT * FROM Customers WHERE CustomerID = ?

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

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

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

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