WeakEventManager.ListenerList Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit une liste des collections intégrées permettant de stocker des écouteurs pour WeakEventManager.
protected: ref class WeakEventManager::ListenerList
protected class WeakEventManager.ListenerList
Protected Class WeakEventManager.ListenerList
- Héritage
-
WeakEventManager.ListenerList
- Dérivé
Remarques
Bien que cette liste contienne des membres qui ressemblent à ceux définis par IList et ICollection, et fournissent des fonctionnalités similaires, cette classe n’implémente aucune de ces interfaces.
La plupart des WeakEventManager classes dérivées n’ont pas besoin d’utiliser des membres sur WeakEventManager.ListenerList. Les WeakEventManager méthodes ProtectedAddListener et ProtectedRemoveListener utilisent une valeur par défaut WeakEventManager.ListenerList en interne, une liste pour chaque source
.
Vous n’avez besoin d’appeler WeakEventManager.ListenerList des méthodes que si votre WeakEventManager classe gère plusieurs listes pour la même combinaison événement-source, chaque liste étant créée pour tenir compte des différentes conditions de l’événement. Dans ce cas, vous n’utiliseriez ProtectedAddListener pas et ProtectedRemoveListener et implémenteriez AddListener
plutôt ou RemoveListener
pour agir sur les écouteurs dans l’une des listes d’écouteurs internes, généralement en fonction d’un paramètre que vous ajoutez à AddListener
ou RemoveListener
. En outre, l’implémentation du gestionnaire qui reçoit l’événement brut ne peut pas simplement appeler DeliverEvent; vous devez à la place suivre les spécificités de l’événement et remettre l’événement uniquement à la liste appropriée à l’aide DeliverEventToListde .
Les différentes méthodes de WeakEventManager.ListenerList sont fournies afin que vous puissiez travailler avec vos listes internes et que vous puissiez empêcher la modification de la liste lors de la remise réelle de l’événement.
Un exemple de classe qui a utilisé cette technique d’implémentation est PropertyChangedEventManager, qui gère des listes d’écouteurs distinctes pour PropertyChanged
en fonction de la propriété modifiée.
Utilisation du texte XAML
Vous ne pouvez pas utiliser cette classe en XAML.
Constructeurs
WeakEventManager.ListenerList() |
Initialise une nouvelle instance de la classe WeakEventManager.ListenerList. |
WeakEventManager.ListenerList(Int32) |
Initialise une nouvelle instance de la classe WeakEventManager.ListenerList avec la capacité initiale par défaut. |
Propriétés
Count |
Obtient le nombre d'éléments contenus dans WeakEventManager.ListenerList. |
Empty |
Obtient une valeur qui représente une liste vide dans un but de comparaison. |
IsEmpty |
Obtient une valeur qui déclare si cette occurrence de WeakEventManager.ListenerList est vide. |
Item[Int32] |
Obtient ou définit un élément d'écouteur spécifique dans WeakEventManager.ListenerList. |
Méthodes
Add(IWeakEventListener) |
Ajoute un objet IWeakEventListener à la WeakEventManager.ListenerList. |
AddHandler(Delegate) |
Ajoute un gestionnaire d'événements au WeakEventManager.ListenerList. |
BeginUse() |
Déclare la liste pour laquelle lancer l'utilisation. Cela empêche des modifications directes à la liste pendant les itérations des éléments de la liste. |
Clone() |
Crée un clone modifiable de cette WeakEventManager.ListenerList. |
CopyTo(WeakEventManager+ListenerList) |
Copie le actuel WeakEventManager.ListenerList vers le spécifié WeakEventManager.ListenerList. |
DeliverEvent(Object, EventArgs, Type) |
Remet l'événement qui est géré à chaque écouteur dans la WeakEventManager.ListenerList. |
EndUse() |
Déverrouille l'état initialisé par BeginUse(). |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
PrepareForWriting(WeakEventManager+ListenerList) |
Vérifie que la liste fournie est en cours d'utilisation et, le cas échéant, affecte au paramètre de référence de la liste une copie de cette liste plutôt que son original. |
Purge() |
Supprime toutes les entrées dans la liste où la cible de référence sous-jacente correspond à une référence nulle. |
Remove(IWeakEventListener) |
Supprime la première occurrence d'un élément d'écouteur de WeakEventManager.ListenerList. |
RemoveHandler(Delegate) |
Supprime un gestionnaire d'événements de la WeakEventManager.ListenerList. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |