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

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

  • Статья

Область применения: Access 2013, Office 2013

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

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

Задает или возвращает значение String , содержащее команду поставщика, например инструкцию 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-адреса.