Execute Method (подключение ADO)

Выполняет указанный запрос, инструкцию SQL, хранимую процедуру или текст для конкретного поставщика.

Синтаксис

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  

Возвращаемое значение

Возвращает ссылку на объект Recordset (ADO).

Параметры

CommandText
Строковое значение, содержащее инструкцию SQL, хранимую процедуру, URL-адрес или текст для конкретного поставщика для выполнения. При необходимости имена таблиц можно использовать, но только если поставщик учитывает SQL. Например, если используется имя таблицы "Клиенты", ADO автоматически присвоит стандартному синтаксису SQL Select для формирования и передачи инструкции SELECT * FROM Customers в качестве инструкции Transact-SQL поставщику.

RecordsAffected
Необязательно. Переменная Long, в которую поставщик возвращает количество записей, затронутых операцией.

Параметры
Необязательно. Длинное значение, указывающее, как поставщик должен оценивать аргумент CommandText. Может быть битовой маской одного или нескольких значений CommandTypeEnum или ExecuteOptionEnum .

Заметка Используйте значение ExecuteOptionEnumadExecuteNoRecords для повышения производительности, минимизируя внутреннюю обработку и перенос приложений из Visual Basic 6.0.

Не используйте adExecuteStream с методом Execute объекта Connection .

Не используйте значения CommandTypeEnum adCmdFile или adCmdTableDirect с Execute. Эти значения можно использовать только в качестве параметров с помощью метода Open Method (ADO Recordset) и методов метода Requeryнабора записей.

Замечания

Использование метода Execute в объекте ADO выполняет любой запрос, который передается методу в аргументе CommandText для указанного соединения. Если аргумент CommandText задает запрос, возвращающий строку, все результаты, создаваемые выполнением, хранятся в новом объекте Recordset . Если команда не предназначена для возврата результатов (например, запроса SQL UPDATE), поставщик возвращает значение Nothing до тех пор, пока указан параметр adExecuteNoRecords ; в противном случае Выполнение возвращает закрытый набор записей.

Возвращаемый объект Recordset всегда является курсором только для чтения. Если вам нужен объект Recordset с дополнительными функциями, сначала создайте объект Recordset с нужными параметрами свойств, а затем используйте метод Open Method объекта Recordset (ADO Recordset) для выполнения запроса и возврата требуемого типа курсора.

Содержимое аргумента CommandText зависит от поставщика и может быть стандартным синтаксисом SQL или любым специальным форматом команд, поддерживаемым поставщиком.

Событие ExecuteComplete будет выдано при завершении этой операции.

Замечание

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

Применимо к

объект подключения (ADO)