EventHandler Delegat

Definicja

Przestrzeń nazw:
System
Zestawy:
mscorlib.dll, System.Runtime.dll
Zestawy:
netstandard.dll, System.Runtime.dll
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
EventHandler.cs
Źródło:
EventHandler.cs
Źródło:
IdnMapping.cs

Reprezentuje metodę, która będzie obsługiwać zdarzenie, które nie zawiera danych zdarzenia.

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)

Parametry

sender
Object

Źródło zdarzenia.

e
EventArgs

Obiekt, który nie zawiera danych zdarzenia.

Atrybuty
SerializableAttribute ComVisibleAttribute

Uwagi

Model zdarzeń w .NET opiera się na delegowaniu zdarzeń, który łączy zdarzenie z jego procedurą obsługi. Aby zgłosić zdarzenie, potrzebne są dwa elementy:

  • Delegat, który identyfikuje metodę, która zapewnia odpowiedź na zdarzenie.
  • Opcjonalnie klasa, która przechowuje dane zdarzenia, jeśli zdarzenie dostarcza dane.

Delegat jest typem, który definiuje podpis, czyli zwracany typ wartości i typy listy parametrów dla metody. Możesz użyć typu delegata, aby zadeklarować zmienną, która może odwoływać się do dowolnej metody z tym samym podpisem co delegat.

Standardowy podpis delegata procedury obsługi zdarzeń definiuje metodę, która nie zwraca wartości. Pierwszy parametr tej metody jest typu Object i odwołuje się do wystąpienia, które zgłasza zdarzenie. Drugi parametr pochodzi z typu EventArgs i przechowuje dane zdarzenia. Jeśli zdarzenie nie generuje danych zdarzenia, drugi parametr jest po prostu wartością EventArgs.Empty pola. W przeciwnym razie drugi parametr jest typem pochodzącym z EventArgs i dostarcza wszystkie pola lub właściwości potrzebne do przechowywania danych zdarzenia.

Delegat EventHandler jest wstępnie zdefiniowanym pełnomocnikiem, który w szczególności reprezentuje metodę obsługi zdarzeń dla zdarzenia, które nie generuje danych. Jeśli zdarzenie generuje dane, musisz użyć ogólnej EventHandler<TEventArgs> klasy delegata.

Aby skojarzyć zdarzenie z metodą, która będzie obsługiwać zdarzenie, dodaj wystąpienie delegata do zdarzenia. Procedura obsługi zdarzeń jest wywoływana za każdym razem, gdy wystąpi zdarzenie, chyba że usuniesz delegata.

Aby uzyskać więcej informacji na temat delegatów programu obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Metody rozszerzania

Nazwa Opis
GetMethodInfo(Delegate)

Pobiera obiekt reprezentujący metodę reprezentowaną przez określonego delegata.

Dotyczy

Zobacz też