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

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

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

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

Remarks

Используйте свойство 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 Properties Example (VC++)
Метод Requery
ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction Properties Example (JScript)