OleDbCommand.CommandText Свойство

Определение

Возвращает или задает оператор SQL или хранимую процедуру, выполняемую над источником данных.Gets or sets the SQL statement or stored procedure to execute at the data source.

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
Public Property CommandText As String

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

Инструкция или хранимая процедура SQL, подлежащая выполнению.The SQL statement or stored procedure to execute. Значение по умолчанию - пустая строка.The default value is an empty string.

Реализации

Атрибуты

Примеры

В следующем примере создается OleDbCommand и задаются некоторые его свойства.The following example creates an OleDbCommand and sets some of its properties.

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 должно быть присвоено имя хранимой процедуры.When the CommandType property is set to StoredProcedure, the CommandType property should be set to the name of the stored procedure. Пользователю может потребоваться использовать синтаксис escape-символов, если имя хранимой процедуры содержит какие-либо специальные символы.The user may be required to use escape character syntax if the stored procedure name contains any special characters. Команда выполняет эту хранимую процедуру при вызове одного из методов Execute.The command executes this stored procedure when you call one of the Execute methods.

Если CommandType имеет значение TableDirect, то свойству CommandType должно быть присвоено имя таблицы или таблиц, к которым будет осуществляться доступ.When CommandType is set to TableDirect, the CommandType property should be set to the name of the table or tables to be accessed. Пользователю может потребоваться использовать синтаксис escape-символов, если любая из именованных таблиц содержит специальные символы.The user may be required to use escape character syntax if any of the named tables contain any special characters. Все строки и столбцы именованной таблицы или таблиц будут возвращены при вызове одного из методов Execute.All rows and columns of the named table or tables will be returned when you call one of the Execute methods.

Нельзя задать свойства Connection, CommandTypeи CommandText, если текущее соединение выполняет операцию выполнения или выборки.You cannot set the Connection, CommandType, and CommandText properties if the current connection is performing an execute or fetch operation.

Поставщик OLE DB.NET не поддерживает именованные параметры для передачи параметров в инструкцию SQL или хранимую процедуру, вызываемую OleDbCommand, когда CommandType имеет значение Text.The OLE DB.NET Provider does not support named parameters for passing parameters to an SQL Statement or a stored procedure called by an OleDbCommand when CommandType is set to Text. В этом случае необходимо использовать заполнитель вопросительного знака (?).In this case, the question mark (?) placeholder must be used. Например:For example:

SELECT * FROM Customers WHERE CustomerID = ?

Таким образом, порядок, в котором OleDbParameter объекты добавляются в OleDbParameterCollection, должен напрямую соответствовать положению заполнителя вопросительного знака для параметра.Therefore, the order in which OleDbParameter objects are added to the OleDbParameterCollection must directly correspond to the position of the question mark placeholder for the parameter.

Дополнительные сведения см. в разделе Настройка параметров и типов данных параметров.For more information, see Configuring Parameters and Parameter Data Types.

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

Дополнительно