7.2.1. Свойства компонента adoConnection.

• Commands - Представляет собой индексированный список команд ADO, которые являются объектами класса TADOCommand

• CommandCount - Содержит количество доступных команд ADO

• ConnectOptions - Определяет тип подключения: синхронное или асинхронное. Это свойство принимает одно из двух значений:

• coConnectUnspecified -синхронное соединение, которое обязательно ожидает результат последнего запроса и только после этого выполняет следующий запрос;

• coAsyncConnect - асинхронное соединение, которое дает возможность выполнять новые запросы без ожидания результатов предыдущих запросов

• DataSetCount - Показывает количество активных наборов данных, ассоциированных с компонентом ADOConnection

• KeepConnection - Если установлено в true, то обеспечивает сохранение соединения в открытом состоянии в случае, если в текущий момент времени к компоненту ADOConnection не подключен ни один активный набор данных. Если же данное свойство имеет значение false, то соединение будет немедленно разорвано, сразу же после закрытия последнего связанного с ним набора данных

• LoginPrompt - Это свойство отвечает за вопрос. Будет ли при открытии соединения отображаться специальное диалоговое окно, в котором пользователь должен вводить имя и пароль доступа. Рекомендуется установить данное свойство в false, если имя пользователя и пароль не используются

• Mode С помощью этого свойства можно установить операции, доступные для соединения (только чтение, только запись, запись и чтение и т. д.). Обычно настройка разрешенных операций доступа к данным производится на этапе проектирования на вкладке Дополнительно окна Свойства связи с данными

Рассмотрим еще два свойства компонента ADOConnection.

Свойство State позволяет узнать текущее состояние соединения. Оно может иметь одно из следующих значений:

• stClosed - соединение неактивно и закрыто;

• stOpen - соединение открыто, но неактивно;

• stConnecting - выполняется подключение к базе данных;

• stExecuting - реализуется обращение к базе данных;

• stFetching - происходит получение данных из БД.

Свойство DataSets[Index: Integer] представляет собой индексированный массив всех активных наборов данных, связанных с компонентом ADOConnection.

Активным считается тот набор данных, который открыт в текущий момент времени.

Это свойство удобно использовать для открытия всех связанных наборов данных при активизации соединения, например, используя процедуру:

procedure Forml.ADOConnectionl.AfterConnect(Sender: TObject);

begin

for i:= 0 to ADOConnectionl.DataSetCount - 1 do

ADOConnectionl.DataSets[i].Open;

end;

Аналогичным образом, в обработчике события OnBeforeDisconnect можно обеспечить закрытие связанных наборов данных перед отключением соединения (события компонента ADOConnection рассмотрены ниже).

7.2.2. Методы компонента adoConnection

Метод Execute применяется для выполнения команд ADO без использования других компонентов (таких, как АООСоттаnd).

Этот метод является перегружаемым и имеет два варианта описания в виде функции:

function Execute(const CommandText: WideString;

const CommandType: TCommandType = cmdText;

const ExecuteOptions: TExecuteOptions = []): _RecordSet;

overload;

или в виде процедуры:

procedure Execute(const CommandText: WideString;

var RecordsAffected: Integer; ExecuteOptions:

TExecuteOptions = [eoExecuteNoRecords]);

overload;

Функция Execute вызывается, если результатом выполнения команды ADO является набор записей.

Процедура Execute выполняет команду ADO в случае, когда в результате не возвращаются никакие записи.

В этом методе параметр CommandText содержит текст команды ADO. Параметр CommandType более подробно рассмотрен ниже.

Параметр RecordsAffected показывает количество записей, обработанных командой ADO.

Параметр ExecuteOptions задает условия выполнения команды и может принимать такие значения:

• eoAsyncEcexute — команда выполняется асинхронно;

• eoAsyncFetch - команда асинхронно получает необходимые записи;

• eoAsyncFetchNonBlocking - команда выполняется, не блокируя поток;

• eoEcexuteNoRecords - команда не возвращает записей.

При использовании компонента соединения ADOConnection нередко возникает необходимость создавать обработчики следующих событий:

• OnBeforeConnect - возникает перед открытием соединения;

• OnAfterConnect - генерируется после открытия соединения;

• OnBeforeDisconnect - возникает перед закрытием соединения;

• OnAfterDisconnect - происходит после закрытия соединения;

• OnWillConnect - возникает непосредственно перед реальным открытием соединения после получения соответствующего подтверждения от провайдера данных. Это событие будет сгенерировано, после того как источник данных принял команду для выполнения и сообщил об этом компоненту соединения, но перед тем, как произойдет собственно выполнение команды;

• OnExecuteComplete - возникает после выполнения команды ADO.