Свойство 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, and Direction Properties Example (VB)
Примеры свойств ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction (VC++)
Метод Requery
Пример свойств ActiveConnection, CommandText, CommandTimeout, CommandType, Size и Direction (JScript)