ADO/WFC

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

ADO для классов Windows Foundation (ADO/WFC) основан на модели событий ADO и представляет собой упрощенный интерфейс программирования приложений. Как правило, ADO/WFC перехватывает события ADO, объединяет параметры события в один класс событий, а затем вызывает обработчик событий.

Использование событий ADO в ADO/WFC

1. Определите собственный обработчик событий для обработки события. Например, если вы хотите обработать событие ConnectComplete в семействе ConnectionEvent , можно использовать следующий код:

   
   public void onConnectComplete(Object sender,ConnectionEvent e) 
   { 
       System.out.println("onConnectComplete:" + e); 
   } 
   

2. Определите объект обработчика для представления обработчика событий. Объект обработчика должен иметь тип данных ConnectEventHandler для события типа ConnectionEvent или тип данных RecordsetEventHandler для события типа RecordsetEvent. Например, кодируйте следующий код для обработчика событий ConnectComplete :

       ConnectionEventHandler handler =  
               new ConnectionEventHandler(this, "onConnectComplete"); 
   

   Первый аргумент конструктора ConnectionEventHandler является ссылкой на класс, содержащий обработчик событий с именем во втором аргументе. Компилятор Microsoft Visual J++ также поддерживает эквивалентный синтаксис:

   
       ConnectionEventHandler handler =  
           new ConnectionEventHandler(this, "onConnectComplete"); 
   

   
       ConnectionEventHandler handler =  
           new ConnectionEventHandler(this.onConnectComplete); 
   

   Первый аргумент конструктора ConnectionEventHandler является ссылкой на класс, содержащий обработчик событий с именем во втором аргументе. Компилятор Microsoft Visual J++ также поддерживает эквивалентный синтаксис:

   
       ConnectionEventHandler handler =  
           new ConnectionEventHandler(this.onConnectComplete); 
   

   Один аргумент является ссылкой на требуемый класс (this) и метод в классе (onConnectComplete).

3. Добавьте обработчик событий в список обработчиков, предназначенных для обработки события определенного типа. Используйте метод с именем, например addOnEventName(handler).

4. ADO/WFC внутренне реализует все обработчики событий ADO. Таким образом, событие, вызванное операцией подключения или набора записей , перехватывается обработчиком событий ADO/WFC. Обработчик событий ADO/WFC передает параметры ADO ConnectionEvent в экземпляре класса ADO/WFC ConnectionEvent или параметры ADO RecordsetEvent в экземпляре класса ADO/WFC RecordsetEvent . Эти классы ADO/WFC объединяют параметры события ADO; то есть каждый класс ADO/WFC содержит один член данных для каждого уникального параметра во всех методах ADO ConnectionEvent или RecordsetEvent .

5. Затем ADO/WFC вызывает обработчик событий с объектом события ADO/WFC. Например, обработчик onConnectComplete имеет такую подпись:

   
       public void onConnectComplete(Object sender,ConnectionEvent e) 
   

   Первый аргумент — это тип объекта, отправляющего событие (Connection или Recordset), а второй аргумент — объект события ADO/WFC (ConnectionEvent или RecordsetEvent). Сигнатура обработчика событий проще, чем событие ADO. Однако необходимо по-прежнему понимать модель событий ADO, чтобы узнать, какие параметры применяются к событию и как реагировать.

6. Вернитесь из обработчика событий в обработчик ADO/WFC для события ADO. ADO/WFC копирует соответствующие элементы данных событий ADO/WFC обратно в параметры события ADO, а затем возвращает обработчик событий ADO.

7. Завершив обработку, удалите обработчик из списка обработчиков событий ADO/WFC. Используйте метод с именем, например removeOnEventName(handler).