Доступные версии документации

Класс DbCommand

Экземпляр класса DbCommand представляет собой SQL-запрос или вызов хранимой процедуры, снабженный методами для выполнения этого запроса. Объекты DbCommand могут выполнять группу запросов, разделенных знаком «;» в пределах одной команды. В этом случае коллекция параметров должна объединять все параметры из всех запросов.

Примечание

В текущей версии ADO.NET провайдера не поддерживается выполнение группы запросов, среди которых есть запрос создания хранимой процедуры, триггера или EXECUTE BLOCK. В этом случае команда должна содержать только один запрос, который выполняет любое из вышеуказанных действий.

Класс DbCommand дает возможность выполнять запрос разными способами:

  • если запрос не возвращает записи, необходимо вызвать метод ExecuteNonQuery;

  • если запрос возвращает записи, необходимо вызвать метод ExecuteReader, который возвращает объект DataReader, позволяющий просматривать записи;

  • если необходимо получить только первое поле первой записи, необходимо вызвать метод ExecuteScalar.

Класс DbCommand дает возможность выполнять запросы в асинхронном режиме (см. приложение 1).

Для освобождения объекта DbCommand надо использовать оператор using или блок try...finally (см. приложение 2).

Конструкторы класса приведены в таблице 12.

Таблица 12. Конструкторы класса DbCommand
Конструктор Описание
LinterDbCommand() Создает новый объект DbCommand с параметрами по умолчанию.
LinterDbCommand(String) Создает новый объект DbCommand с указанным SQL-запросом.
LinterDbCommand(String, LinterDbConnection) Создает новый объект DbCommand с указанным SQL-запросом по заданному соединению с источником данных.
LinterDbCommand(String,LinterDbConnection,LinterDbTransaction) Создает новый объект DbCommand с указанным SQL-запросом по заданному соединению с источником данных и режимом обработки транзакций.

Свойства класса приведены в таблице 13.

Таблица 13. Свойства класса DbCommand
Свойство Описание
CommandText Предоставляет/устанавливает текущее значение текста SQL-запроса.
CommandTimeout Предоставляет/устанавливает максимально допустимый интервал ожидания завершения выполнения SQL-запроса сервером источника данных.
CommandType Индикатор типа SQL-запроса (доступ к таблице или к хранимой процедуре).
Connection Предоставляет/устанавливает объект DbConnection (соединение), который должен использоваться (используется) для соединения с источником данных.
DesignTimeVisible Индикатор видимости объекта DbCommand в настраиваемом элементе управления интерфейса разработчика программного обеспечения (Windows Forms Designer).
Parameters Предоставляет описание параметров параметризованного SQL-запроса или хранимой процедуры.
Transaction Предоставляет/устанавливает значение объекта DbTransaction, используемого в соединении с источником данных.
UpdatedRowSource Индикатор механизма изменения данных в объекте DataRow после выполнения метода Update DbDataAdapter.

Методы класса приведены в таблице 14.

Таблица 14. Методы класса DbCommand
Метод Описание
Cancel Отмена выполнения команды по текущему соединению.
CreateParameter Создает новый экземпляр объекта DbParameter.
ExecuteNonQuery Выполняет SQL-запрос, не возвращающий данные.
ExecuteReader Выполняет свойство CommandText по соединению Connection и помещает результаты (обычно выборку данных) в объект DbDataReader.
ExecuteReader(CommandBehavior) Выполняет свойство CommandText по соединению Connection и помещает результаты (обычно выборку данных) согласно заданным в аргументе CommandBehavior условиям в объект DbDataReader.
ExecuteScalar Выполняет SQL-запрос и возвращает первый столбец первой строки результирующей выборки данных.
Prepare Подготавливает параметризованный SQL-запрос или хранимую процедур с параметрами для последующего выполнения.

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter