Метод Execute (объект Connection 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.
Примечание. Используйте значение ExecuteOptionEnum adExecuteNoRecords для повышения производительности, минимизируя внутреннюю обработку и перенос приложений из 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 ; в противном случае Execute возвращает закрытый набор записей.
Возвращаемый объект Recordset всегда является курсором только для чтения. Если вам нужен объект Recordset с дополнительными функциями, сначала создайте объект Recordset с нужными параметрами свойств, а затем используйте метод Open Method объекта Recordset (ADO Recordset) для выполнения запроса и возврата требуемого типа курсора.
Содержимое аргумента CommandText зависит от поставщика и может быть стандартным синтаксисом SQL или любым специальным форматом команд, поддерживаемым поставщиком.
Событие ExecuteComplete будет выдано при завершении этой операции.
Примечание.
URL-адреса, использующие схему http, автоматически вызывают поставщика Microsoft OLE DB для публикации в Интернете. Дополнительные сведения см. в разделе "Абсолютные и относительные URL-адреса".