EventHandler Делегат

Определение

Пространство имен:
System
Сборки:
mscorlib.dll, System.Runtime.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
EventHandler.cs
Исходный код:
EventHandler.cs
Исходный код:
IdnMapping.cs

Представляет метод, который будет обрабатывать событие без данных события.

public delegate void EventHandler(System::Object ^ sender, EventArgs ^ e);
public delegate void EventHandler(object sender, EventArgs e);
public delegate void EventHandler(object? sender, EventArgs e);
[System.Serializable]
public delegate void EventHandler(object sender, EventArgs e);
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public delegate void EventHandler(object sender, EventArgs e);
type EventHandler = delegate of obj * EventArgs -> unit
[<System.Serializable>]
type EventHandler = delegate of obj * EventArgs -> unit
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type EventHandler = delegate of obj * EventArgs -> unit
Public Delegate Sub EventHandler(sender As Object, e As EventArgs)

Параметры

sender
Object

Источник события.

e
EventArgs

Объект, содержащий данные о событии.

Атрибуты
SerializableAttribute ComVisibleAttribute

Комментарии

Модель событий в .NET основана на наличии делегата события, который подключает событие к обработчику. Для создания события требуются два элемента:

  • Делегат, определяющий метод, предоставляющий ответ на событие.
  • При необходимости класс, содержащий данные события, если событие предоставляет данные.

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

Стандартная сигнатура делегата обработчика событий определяет метод, который не возвращает значение. Первый параметр этого метода имеет тип Object и ссылается на экземпляр, который вызывает событие. Второй параметр является производным от типа EventArgs и содержит данные события. Если событие не создает данные о событиях, второй параметр — это просто значение EventArgs.Empty поля. В противном случае второй параметр является типом, производным от EventArgs всех полей или свойств, необходимых для хранения данных события.

Делегат EventHandler — это предопределенный делегат, который специально представляет метод обработчика событий для события, который не создает данные. Если событие создает данные, необходимо использовать универсальный EventHandler<TEventArgs> класс делегата.

Чтобы связать событие с методом, который будет обрабатывать событие, добавьте экземпляр делегата в событие. Обработчик событий вызывается всякий раз, когда происходит событие, если вы не удалите делегат.

Дополнительные сведения о делегатах обработчика событий см. в разделе "Обработка и создание событий".

Методы расширения

Имя Описание
GetMethodInfo(Delegate)

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

Применяется к

См. также раздел