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

Метод Execute (команда ADO)

  • Статья

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

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

Синтаксис

Для команды recordset -returning:

Для команды, не возвращающей набор записей:

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

Возвращает ссылку на объект Recordset или Nothing.

Параметры

  • RecordsAffected

    • Необязательный параметр. Переменная Long , в которую поставщик возвращает количество записей, затронутых операцией. Параметр RecordsAffected применяется только к запросам действий или хранимым процедурам. RecordsAffected не возвращает количество записей, возвращаемых запросом или хранимой процедурой, возвращающей результат. Чтобы получить эти сведения, используйте свойство RecordCount . Метод Execute не возвращает правильные сведения при использовании с adAsyncExecute, просто потому, что при асинхронном выполнении команды количество затронутых записей может быть еще неизвестно при возврате метода.

  • Parameters

    • Необязательный параметр. Массив Variant значений параметров, передаваемых с помощью инструкции SQL. (Выходные параметры не возвращают правильные значения при передаче в этом аргументе.)

  • Параметры

    • Необязательный параметр. Значение Long , указывающее, как поставщик должен оценивать свойство CommandText объекта Command . Может быть значением битовой маски, выполненным с помощью значений CommandTypeEnum и (или ) ExecuteOptionEnum . Например, можно использовать adCmdText и adExecuteNoRecords вместе в сочетании , если требуется, чтобы ADO оценило значение свойства CommandText как текст и указало, что команда должна отменить и не возвращать записи, которые могут быть созданы при выполнении текста команды.

Замечания

При использовании метода Execute для объекта Command выполняется запрос, указанный в свойстве CommandText объекта . Если свойство CommandText задает возвращающий строки запрос, все результаты, создаваемые при выполнении, сохраняются в новом объекте Recordset . Если команда не является запросом, возвращающим строки, поставщик возвращает закрытый объект Recordset . Некоторые языки приложений позволяют игнорировать это возвращаемое значение, если не требуется набор записей .

Если запрос содержит параметры, используются текущие значения параметров объекта Command , если вы не переопределите их значениями параметров, переданными при вызове Execute . Можно переопределить подмножество параметров, опустив новые значения для некоторых параметров при вызове метода Execute . Порядок, в котором указываются параметры, совпадает с порядком их передачи методом. Например, если было четыре (или больше) параметров и вы хотите передать новые значения только для первого и четвертого параметров, следует передать в качестве аргумента Parameters .

Примечание.

Выходные параметры не возвращают правильные значения при передаче в аргумент Parameters .

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

См. также

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.