WeakEventManager.ListenerList Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine integrierte Auflistung zum Speichern von Listenern für einen WeakEventManager bereit.
protected: ref class WeakEventManager::ListenerListprotected class WeakEventManager.ListenerListProtected Class WeakEventManager.ListenerList- Vererbung
-
WeakEventManager.ListenerList
- Abgeleitet
Hinweise
Obwohl diese Liste Member enthält, die denen ähneln, die durch IList und ICollectiondefiniert sind, und ähnliche Funktionen bereitstellen, implementiert diese Klasse keine dieser Schnittstellen.
Die meisten WeakEventManager abgeleiteten Klassen müssen keine Member für WeakEventManager.ListenerListverwenden. Die WeakEventManager Methoden ProtectedAddListener und ProtectedRemoveListener verwenden intern eine Standardliste WeakEventManager.ListenerList , eine Liste für jede source.
Sie müssen nur Methoden aufrufen WeakEventManager.ListenerList , wenn Ihre WeakEventManager Klasse mehrere Listen für die gleiche Ereignis-Quell-Kombination verwaltet, wobei jede Liste erstellt wird, um verschiedene Bedingungen des Ereignisses zu berücksichtigen. In diesem Fall würden Sie nicht und ProtectedRemoveListener verwenden ProtectedAddListener und stattdessen oder RemoveListener implementieren, um Listener nur in einer der internen Listenerlisten zu bearbeitenAddListener, die in der Regel auf einem Parameter basieren, den Sie zu oder RemoveListenerhinzufügenAddListener. Außerdem kann die Handlerimplementierung, die das Unformatierte Ereignis empfängt, nicht einfach aufrufen DeliverEvent. Sie müssen stattdessen die Besonderheiten des Ereignisses nachverfolgen und das Ereignis nur mithilfe von an die entsprechende Liste übermitteln DeliverEventToList.
Die verschiedenen Methoden von WeakEventManager.ListenerList werden bereitgestellt, damit Sie mit Ihren internen Listen arbeiten können und so änderungen der Liste während der tatsächlichen Übermittlung des Ereignisses verhindern können.
Eine Beispielklasse, die diese Implementierungsmethode verwendet hat, ist PropertyChangedEventManager, die separate Listenerlisten für PropertyChanged verwaltet, je nachdem, welche Eigenschaft geändert wurde.
XAML-Textverwendung
Sie können diese Klasse nicht in XAML verwenden.
Konstruktoren
| WeakEventManager.ListenerList() |
Initialisiert eine neue Instanz der WeakEventManager.ListenerList-Klasse. |
| WeakEventManager.ListenerList(Int32) |
Initialisiert eine neue Instanz der WeakEventManager.ListenerList-Klasse mit der angegebenen anfänglichen Kapazität. |
Eigenschaften
| Count |
Ruft die Anzahl der Elemente in WeakEventManager.ListenerList ab. |
| Empty |
Ruft einen Wert ab, der eine leere Liste für Vergleiche darstellt. |
| IsEmpty |
Ruft einen Wert ab, der angibt, ob diese WeakEventManager.ListenerList leer ist. |
| Item[Int32] |
Ruft ein bestimmtes Listenerelement in der WeakEventManager.ListenerList ab oder legt dieses fest. |
Methoden
| Add(IWeakEventListener) |
Fügt ein IWeakEventListener-Objekt der WeakEventManager.ListenerList-Auflistung hinzu. |
| AddHandler(Delegate) |
Fügt der WeakEventManager.ListenerList einen Ereignishandler hinzu. |
| BeginUse() |
Gibt an, dass die Liste verwendet wird. Dadurch werden Änderungen an der Liste während der Iteration von Listenelementen verhindert. |
| Clone() |
Erstellt einen änderbaren Klon dieser WeakEventManager.ListenerList. |
| CopyTo(WeakEventManager+ListenerList) |
Kopiert den aktuellen WeakEventManager.ListenerList in den angegebenen WeakEventManager.ListenerList. |
| DeliverEvent(Object, EventArgs, Type) |
Übermittelt das verwaltete Ereignis an alle Listener in der WeakEventManager.ListenerList. |
| EndUse() |
Hebt den gesperrten Status auf, der von BeginUse() initiiert wurde. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| PrepareForWriting(WeakEventManager+ListenerList) |
Überprüft eine mögliche Verwendung der bereitgestellten Liste und legt die Verweisparameter der Liste ggf. auf eine Kopie der Liste fest. |
| Purge() |
Entfernt alle Einträge aus der Liste mit dem zugrunde liegenden Verweisziel als NULL-Verweis. |
| Remove(IWeakEventListener) |
Entfernt das erste Vorkommen eines Listenerelements aus der WeakEventManager.ListenerList. |
| RemoveHandler(Delegate) |
Entfernt einen Ereignishandler aus der WeakEventManager.ListenerList. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
