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

Объект command (ADO)

  • Статья

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

Определяет конкретную команду, которую вы планируете выполнить в источнике данных.

Замечания

Используйте объект Command для запроса базы данных и возврата записей в объекте Recordset , выполнения массовой операции или для управления структурой базы данных. В зависимости от функциональных возможностей поставщика некоторые коллекции команд, методы или свойства могут создавать ошибку при указании ссылки.

С помощью коллекций, методов и свойств объекта Command можно сделать следующее:

  • Определите исполняемый текст команды (например, инструкцию SQL) с помощью свойства CommandText .

  • Определите параметризованные запросы или аргументы хранимой процедуры с помощью объектов Parameter и коллекции Parameters .

  • Выполните команду и при необходимости верните объект Recordset с помощью метода Execute .

  • Укажите тип команды со свойством CommandType перед выполнением, чтобы оптимизировать производительность.

  • Управление сохранением поставщиком подготовленной (или скомпилированной) версии команды перед выполнением с помощью свойства Prepared .

  • Задайте количество секунд, в течение которых поставщик будет ожидать выполнения команды со свойством CommandTimeout .

  • Свяжите открытое соединение с объектом Command , задав его свойство ActiveConnection .

  • Задайте свойство Name , чтобы определить объект Command в качестве метода для связанного объекта Connection .

  • Передайте объект Command в свойство Sourceнабора записей , чтобы получить данные.

  • Доступ к атрибутам поставщика с помощью коллекции Properties .

Примечание.

Чтобы выполнить запрос без использования объекта Command , передайте строку запроса в метод Execute объекта Connection или в метод Open объекта Recordset . Однако объект Command необходим, если требуется сохранить текст команды и повторно выполнить его или использовать параметры запроса.

Чтобы создать объект Command независимо от ранее определенного объекта Connection, задайте для его свойства ActiveConnection допустимое строка подключения. ADO по-прежнему создает объект Connection , но не назначает этот объект переменной объекта. Однако при связывании нескольких объектов Command с одинаковым соединением следует явно создать и открыть объект Connection . при этом объект Connection назначается переменной объекта . Если свойство ActiveConnection объекта Command не задано для этой объектной переменной, ADO создает новый объект Connection для каждого объекта Command, даже если используется тот же строка подключения.

Чтобы выполнить команду, просто вызовите ее по свойству Name для связанного объекта Connection . Для свойстваActiveConnection command должно быть задано значение объекта Connection . Если команда содержит параметры, передайте их значения в качестве аргументов в метод .

Если при одном соединении выполняются два или более объектов Command и любой из объектов Command является хранимой процедурой с выходными параметрами, возникает ошибка. Чтобы выполнить каждый объект Command , используйте отдельные подключения или отключите все другие объекты Command от соединения.

Коллекция Parameters является членом объекта Command по умолчанию. В результате следующие два оператора кода эквивалентны.