WeakEventManager.ListenerList Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Udostępnia wbudowaną listę kolekcji do przechowywania odbiorników dla elementu WeakEventManager.
protected: ref class WeakEventManager::ListenerListprotected class WeakEventManager.ListenerListProtected Class WeakEventManager.ListenerList- Dziedziczenie
-
WeakEventManager.ListenerList
- Pochodne
Uwagi
Mimo że ta lista zawiera elementy członkowskie, które przypominają te zdefiniowane przez IList i ICollection, i zapewniają podobne funkcje, ta klasa nie implementuje żadnego z tych interfejsów.
Większość WeakEventManager klas pochodnych nie musi używać żadnych elementów członkowskich w systemie WeakEventManager.ListenerList. Metody WeakEventManager ProtectedAddListener i ProtectedRemoveListener używają domyślnej WeakEventManager.ListenerList wewnętrznie listy dla każdego sourceelementu .
Należy wywołać WeakEventManager.ListenerList metody tylko wtedy, gdy klasa WeakEventManager utrzymuje wiele list dla tej samej kombinacji źródła zdarzeń, z każdą listą utworzoną w celu uwzględnienia różnych warunków zdarzenia. W takim przypadku nie należy używać ProtectedAddListener polecenia i ProtectedRemoveListener zamiast tego implementować AddListener odbiorniki lub RemoveListener działać na odbiornikach tylko w jednej z wewnętrznych list odbiorników, zazwyczaj na podstawie parametru dodawanego do AddListener lub RemoveListener. Ponadto implementacja procedury obsługi, która odbiera nieprzetworzone zdarzenie, nie może po prostu wywołać . DeliverEventZamiast tego należy śledzić szczegóły zdarzenia i dostarczać zdarzenie tylko do odpowiedniej listy przy użyciu polecenia DeliverEventToList.
Dostępne są różne metody WeakEventManager.ListenerList , dzięki czemu można pracować z listami wewnętrznymi, aby zapobiec modyfikacji listy podczas rzeczywistego dostarczania zdarzenia.
Przykładowa klasa, która korzystała z tej techniki implementacji, to PropertyChangedEventManager, która utrzymuje oddzielne listy odbiorników na PropertyChanged podstawie właściwości, która uległa zmianie.
Użycie tekstu w języku XAML
Nie można użyć tej klasy w języku XAML.
Konstruktory
| WeakEventManager.ListenerList() |
Inicjuje nowe wystąpienie klasy WeakEventManager.ListenerList. |
| WeakEventManager.ListenerList(Int32) |
Inicjuje WeakEventManager.ListenerList nowe wystąpienie klasy o określonej pojemności początkowej. |
Właściwości
| Count |
Pobiera liczbę elementów zawartych w elemecie WeakEventManager.ListenerList. |
| Empty |
Pobiera wartość reprezentującą pustą listę na potrzeby porównań. |
| IsEmpty |
Pobiera wartość, która deklaruje, czy jest ona WeakEventManager.ListenerList pusta. |
| Item[Int32] |
Pobiera lub ustawia określony element odbiornika w elemencie WeakEventManager.ListenerList . |
Metody
| Add(IWeakEventListener) |
IWeakEventListener Dodaje obiekt do obiektu WeakEventManager.ListenerList. |
| AddHandler(Delegate) |
Dodaje procedurę obsługi zdarzeń do elementu WeakEventManager.ListenerList. |
| BeginUse() |
Deklaruje, że lista ma być używana. Zapobiega to bezpośrednim zmianom listy podczas iteracji elementów listy. |
| Clone() |
Tworzy modyfikowalny klon tego WeakEventManager.ListenerListobiektu . |
| CopyTo(WeakEventManager+ListenerList) |
Kopiuje bieżący element WeakEventManager.ListenerList do określonego WeakEventManager.ListenerListelementu . |
| DeliverEvent(Object, EventArgs, Type) |
Dostarcza zdarzenie zarządzane do każdego odbiornika w elemecie WeakEventManager.ListenerList. |
| EndUse() |
Odblokowuje stan blokady zainicjowany przez BeginUse()program . |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| PrepareForWriting(WeakEventManager+ListenerList) |
Sprawdza, czy podana lista jest używana, a jeśli tak, ustawia parametr odwołania listy do kopii tej listy, a nie oryginalny. |
| Purge() |
Usuwa wszystkie wpisy z listy, gdzie bazowy obiekt docelowy odwołania jest odwołaniem o wartości null. |
| Remove(IWeakEventListener) |
Usuwa pierwsze wystąpienie elementu odbiornika z elementu WeakEventManager.ListenerList. |
| RemoveHandler(Delegate) |
Usuwa program obsługi zdarzeń z programu WeakEventManager.ListenerList. |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |