10. C#. События.

На основе делегатов построено еще одно важное средство С#: событие (event). Событие — это по сути автоматическое уведомление о выполнении некоторого действия.

События работают следующим образом. Объект, которому необходима информация о

некотором событии, регистрирует обработчик для этого события. Когда ожидаемое

событие происходит, вызываются все зарегистрированные обработчики. А теперь

внимание: обработчики событий представляются делегатами.

События — это члены класса, которые объявляются с использованием ключевого

слова event. Наиболее распространенная форма объявления события имеет следующий вид:

event событийный_делегат объект;

Здесь элемент событийный_делегат означает имя делегата, используемого для

поддержки объявляемого события, а элемент объект — это имя создаваемого собы-

тийного объекта.

Событие – член типа, позволяющий типу уведомлять другие объекты о наступлении

некоторого события Механизм событий основан на делегатах.

Если в типе определен член-событие, то этот тип (или его экземпляр) может

уведомлять другие объекты о некоторых особых событиях. Скажем, класс Button

(«кнопка») определяет событие Click («щелчок»). В приложении могут быть объекты,

которые должны получать уведомление о щелчке объекта Button, а получив такое

уведомление — исполнять некоторые действия. События — это члены типа,

обеспечивающие такого рода взаимодействие. Тип, в котором определены события, как

минимум поддерживает:

 регистрацию статического метода типа или экземплярного метода объекта,

заинтересованных в получении уведомления о событии;

 отмену регистрации статического метода типа или экземплярного метода

объекта, получающих уведомления о событии;

 уведомление зарегистрированных методов о том, что событие произошло.

Типы могут предоставлять эту функциональность при определении событий,

так как они поддерживают список зарегистрированных методов. Когда событие

происходит, тип уведомляет об этом все зарегистрированные методы.

Модель событий CLR основана на делегатах (delegate). Делегаты позволяют

обращаться к методам обратного вызова (callback method), не нарушая

безопасности типов. Метод обратного вызова — это механизм, позволяющий объекту

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

Проектирование типа, поддерживающего событие:

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

При возникновении события объекту, в котором оно возникло, нужно передать дополнительную информацию объектам-получателям уведомления о событии. Для

предоставления получателям эту информацию нужно инкапсулировать в собственный класс, который содержит набор закрытых полей, а также открытых свойств «только для чтения». В соответствии с соглашением, классы, содержащие информацию о событиях, передаваемую обработчику события, должны наследовать System.EventArgs, а имя типа должно заканчиваться словом EventArgs.

class ClickEventArgs : System.EventArgs {

private readonly int _x, _y;

public ClickEventArgs(int x, int y)

{_x = x; _y = y;}

public int X { get {return _x;} }

public int Y { get {return _y;} }

}

Этап 2: определение члена-события

В С# член-событие объявляется ключевым словом event. Каждому члену-событию

определяется область действия (практически всегда он открытый, поэтому доступен из любого кода), тип делегата, указывающий на прототип вызываемого метода (или методов), и имя (любой допустимый идентификатор).

class Button {

...

public event EventHandler<ClickEventArgs> Click;

...

}

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

void SomeMethod(object sender, ClickEventArgs e)

Этап 3: определение метода, ответственного за уведомление зарегистрированных объектов о событии

В соответствии с соглашением в классе должен быть виртуальный защищенный метод, вызываемый из кода класса и его потомков при возникновении события. Этот метод принимает один параметр, объект MailMsgEventArgs, содержащий дополнительные сведения о событии. Реализация по умолчанию этого метода просто проверяет, есть ли объекты, зарегистрировавшиеся для получения уведомления о событии, и при положительном результате проверки уведомляет зарегистрированные методы о возникновении события.

class Button ...

protected virtual void OnClick(ClickEventArgs e) {}

private void RaiseClick(ClickEventArgs e) {

OnClick(e);

EventHandler<ClickEventArgs> tmp = Click;

if(tmp != null) {

tmp(this, e);

}

}

Этап 4: определение метода, («генерирующего» событие); транслирующего входную информацию в желаемое событие

У класса должен быть метод, принимающий некоторую входную информацию и

преобразующий его в генерацию события.

class Button {

public void SimulateClick(int x, int y) {

ClickEventArgs e = new ClickEventArgs(x, y);

RaiseClick(e);

}

}