Объект Command (ADO)

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

Комментарии

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

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

  • Определите исполняемый текст команды (например, оператор SQL) со свойством CommandText. Кроме того, для структур команд или запросов, отличных от простых строк (например, запросов шаблонов XML), определите команду со свойством CommandStream .

  • При необходимости укажите диалект команды, используемый в CommandText или CommandStream со свойством "Диалект ".

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

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

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

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

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

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

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

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

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

  • Доступ к атрибутам, зависящим от поставщика, с помощью коллекции Свойств .

Примечание

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

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

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

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

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

objCmd.Parameters.Item(0)  
objCmd(0)  
  • Объект Command не является безопасным для создания скриптов.

Этот раздел содержит следующий раздел.

См. также:

Объект Connection (ADO)
Коллекция Parameters (ADO)
Коллекция Properties (ADO)
Приложение А. Поставщики