Свойство CommandText (ADO)

Указывает текст команды, выдаваемой поставщиком.

Параметры и возвращаемые значения

Возвращает или задает строковое значение, содержащее команду поставщика, например инструкцию SQL, имя таблицы, относительный URL-адрес или вызов хранимой процедуры. По умолчанию используется пустая строка ("").

Комментарии

Используйте свойство CommandText , чтобы задать или вернуть текст команды, представленной объектом Command . Обычно это будет оператор SQL, но также может быть любым другим типом инструкции команды, распознаваемой поставщиком, например вызовом хранимой процедуры. Оператор SQL должен иметь определенный диалект или версию, поддерживаемую обработчиком запросов поставщика.

Если свойству Prepared объекта Command присвоено значение True , а объект Command привязан к открытому соединению при установке свойства CommandText , ADO подготавливает запрос (то есть скомпилированную форму запроса, хранящегося поставщиком) при вызове методов Execute или Open .

В зависимости от параметра свойства CommandType ADO может изменить свойство CommandText . Свойство CommandText можно прочитать в любое время, чтобы увидеть фактический текст команды, который будет использоваться ADO во время выполнения.

Используйте свойство CommandText , чтобы задать или вернуть относительный URL-адрес, указывающий ресурс, например файл или каталог. Ресурс относится к расположению, указанному явным образом абсолютным URL-адресом, или неявно открытым объектом Connection .

Примечание

URL-адреса, использующие схему HTTP, автоматически вызывают поставщик Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе Абсолютные и относительные URL-адреса.

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

Объект Command (ADO)

См. также:

ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction Properties Example (VB)
Пример свойств ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction (VC++)
Метод Requery
Пример свойств ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction (JScript)