Делегат EventHandler

Представляет метод со стандартной сигнатурой, предназначенный для обработки события, не содержащего дополнительной информации.

Объявляется следующим образом:

public delegate void EventHandler(object sender, EventArgs e);

Параметры

object sender //Представляет ссылку на объект-источник события.

EventArgs e // Таким образом кодируется информация о событии.

Замечание

Модель событий в .NET Framework основывается на механизме ссылок на функции (events – разновидности класса-делегата), которые обеспечивают стандартную стыковку события с обработчиком. Для возбуждения события необходимы два элемента:

Класс-носитель информации о событии. Должен наследовать от базового класса EventArgs.

Делегат, настроенный на метод, обеспечивающий реакцию на данное событие. Когда создаётся делегат-представитель класса-делегата EventHandler, прежде всего, определяется соответствующий метод, выполнение которого обеспечивает реакцию на событие.

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

1. для идентификации события. Базовый класс EventArgs, если уведомление о произошедшем событии не связано с генерацией дополнительной информации или производный от данного класса класс, если необходимо передавать дополнительную информацию, связанную с событием,

2. предопределённый класс EventHandler для реализации ссылки на метод-обработчик события.

Пример

using System;

namespace Events00

{

// Однопоточное приложение, в котором для реализации механизма

// реакции на события используется стандартный класс-делегат

// System.EventHandler.

// Объявляется класс события, производный от System.EventArgs.

//===================================================================

class EventPosition:System.EventArgs

{

// Дополнительная информация о событии.

public int X;

// Конструктор...

public EventPosition(int key)

{

X = key;

}

}

//===================================================================

/// <summary>

///Базовый класс действующих в приложении объектов.

///Содержит ВСЁ необходимое для того, чтобы объекты производных классов

/// могли адекватно реагировать на заложенные в базовом классе события.

/// </summary>

class BaseClass

{

// Ссылка на это событие идентифицируется как xEvent.

// Это «стандартное» событие.

// xEvent стыкуется со стандартным классом-делегатом System.EventHandler.

public static event System.EventHandler xEvent;

// Статическая переменная-носитель дополнительной информации.

static int xPosition = 0;

// Статическая функция. Это модель процесса непрерывного сканирования.

// Аналог цикла обработки сообщений приложения.

public static void XScaner()

{

while (true)

{//=================================================================

while(true)

{//================================================================

// Источником события является вводимая с клавиатуры

// последовательность символов, соответствующая целочисленному

// значению 50. При получении этого значения просходит уведомление

// подписанных на событие объектов.=============================

try

{

Console.WriteLine(“new xPosition, please: “);

xPosition = Int32.Parse(Console.ReadLine());

break;

}

catch

{

Console.WriteLine(“Incorrect value of xPosition!”);

}

}//================================================================

if (xPosition < 0) break; // Отрицательные значения являются сигналом

// к прекращению выполнения , а при получении 50 - возбуждается событие!

if (xPosition == 50) xEvent(new BaseClass(), new EventPosition(xPosition));

}//=================================================================

}

}

//===================================================================

// Важное обстоятельство! В этом приложении событие возбуждается

// ПРЕДКОМ, а реагирует на него объект-представитель класса ПОТОМКА!

//===================================================================

/// <summary>

/// Объявление первого производного класса.

/// Надо сделать дополнительные усилия для того чтобы объекты этого класса

/// стали бы реагировать на события.

/// </summary>

class ClassONE:BaseClass

{

public void MyFun(object obj, System.EventArgs ev)

{

Console.Write(“{0} - “,this.ToString());

Console.WriteLine

(“{0}:YES! {1}”,((BaseClass)obj).ToString(),((EventPosition)ev).X.ToString());

}

}

/// <summary>

/// Второй класс чуть сложнее. Снабжён конструктором, который позволяет классу

/// самостоятельно «поднисаться» на «интересующее» его событие.

/// </summary>

class ClassTWO:BaseClass

{

public ClassTWO()

{

BaseClass.xEvent += new System.EventHandler(this.MyFun);

}

public void MyFun(object obj, System.EventArgs ev)

{

Console.Write(“{0} - “,this.ToString());

Console.WriteLine

(“{0}:YES! {1}”, ((BaseClass)obj).ToString(), ((EventPosition)ev).X.ToString());

}

}

//==================================================================================

class mainClass

{

static void Main(string[] args)

{

Console.WriteLine(«0______________________________»);

// Создали первый объект и подписали его на получение события.

ClassONE one = new ClassONE();

BaseClass.xEvent += new System.EventHandler(one.MyFun);

// Второй объект подписался сам.

ClassTWO two = new ClassTWO();

// Запустили цикл прослушивания базового класса.

BaseClass.XScaner();

// При получении отрицательного значения цикл обработки

// сообщений прерывается.

Console.WriteLine(«1______________________________»);

// Объект - представитель класса ClassONE перестаёт

// получать уведоомление о событии.

BaseClass.xEvent -= new System.EventHandler(one.MyFun);

// После чего повторно запусткается цикл прослушивания,

// который прекращает выполняться после повторного

// получения отрицательного значения.

BaseClass.XScaner();

Console.WriteLine(“2______________________________”);

}

}

//==================================================================================

}