WeakEventManager Classe

Définition

Espace de noms:
System.Windows
Assembly:
WindowsBase.dll

Fournit une classe de base pour le gestionnaire d’événements utilisé dans le modèle d’événement faible. Le gestionnaire ajoute et supprime des écouteurs pour les événements (ou rappels) qui utilisent également le modèle.

public ref class WeakEventManager abstract : System::Windows::Threading::DispatcherObject
public abstract class WeakEventManager : System.Windows.Threading.DispatcherObject
type WeakEventManager = class
    inherit DispatcherObject
Public MustInherit Class WeakEventManager
Inherits DispatcherObject
Héritage
Object
DispatcherObject
WeakEventManager
Dérivé

Remarques

Vous utilisez généralement le modèle d’événement faible lorsque la source d’événement a une durée de vie d’objet indépendante des écouteurs d’événements. L’utilisation de la fonctionnalité de répartition centralisée des événements d’un WeakEventManager permet aux gestionnaires de l’écouteur d’être récupérés par le garbage collection même si l’objet source persiste. En revanche, une connexion d’événement régulière à l’aide de l’opérateur += entraîne la conservation d’une référence aux écouteurs par la source potentiellement déconnectée. Cela empêche le destinataire d’être récupéré à la mémoire en temps voulu.

Une situation courante où les relations de durée de vie entre les sources et les écouteurs doivent utiliser le modèle d’événement faible est la gestion des événements de mise à jour provenant de liaisons de données.

Le modèle d’événement faible peut également être utilisé pour les rappels et les événements réguliers.

Notes pour les responsables de l’implémentation

Pour obtenir un exemple de modèle personnalisé WeakEventManager, consultez Modèles d’événements faibles.

Constructeurs

Nom Description
WeakEventManager()

Initialise les valeurs de classe de base lorsqu’elle est utilisée comme initialiseur par le constructeur d’une classe dérivée.

Propriétés

Nom Description
Dispatcher

Obtient ce Dispatcher qui DispatcherObject est associé.

(Hérité de DispatcherObject)
Item[Object]

Obtient ou définit les données stockées pour la source spécifiée.
ReadLock

Établit un verrou en lecture sur la table de données sous-jacente et retourne un IDisposable.
WriteLock

Établit un verrou en écriture sur la table de données sous-jacente et retourne un IDisposable.

Méthodes

Nom Description
CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObjectfichier .

(Hérité de DispatcherObject)
DeliverEvent(Object, EventArgs)

Remet l’événement géré à chaque écouteur.
DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList)

Remet l’événement géré à chaque écouteur dans la liste fournie.
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetCurrentManager(Type)

Retourne l’implémentation WeakEventManager utilisée pour le type fourni.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
NewListenerList()

Retourne un nouvel objet pour contenir des écouteurs à un événement.
ProtectedAddHandler(Object, Delegate)

Ajoute le délégué spécifié en tant que gestionnaire d’événements de la source spécifiée.
ProtectedAddListener(Object, IWeakEventListener)

Ajoute l’écouteur fourni à la source fournie pour l’événement géré.
ProtectedRemoveHandler(Object, Delegate)

Supprime le gestionnaire précédemment ajouté de la source spécifiée.
ProtectedRemoveListener(Object, IWeakEventListener)

Supprime un écouteur précédemment ajouté de la source fournie.
Purge(Object, Object, Boolean)

Supprime les entrées d’écouteur inactives de la liste de données pour la source fournie. Retourne true si certaines entrées ont été réellement supprimées de la liste.
Remove(Object)

Supprime tous les écouteurs de la source spécifiée.
ScheduleCleanup()

Demande qu’un vidage des entrées inutilisées dans la liste d’écouteurs sous-jacents soit effectué sur un thread de priorité inférieure.
SetCurrentManager(Type, WeakEventManager)

Définit le gestionnaire actuel pour le type de gestionnaire spécifié.
StartListening(Object)

En cas de substitution dans une classe dérivée, commence à écouter l’événement géré. Une fois la StartListening(Object) méthode appelée, le gestionnaire doit être dans l’état d’appel DeliverEvent(Object, EventArgs) ou DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList) chaque fois que l’événement pertinent de la source fournie est géré.
StopListening(Object)

En cas de substitution dans une classe dérivée, arrête l’écoute sur la source fournie pour l’événement géré.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
VerifyAccess()

Applique que le thread appelant a accès à ce DispatcherObjectfichier .

(Hérité de DispatcherObject)

S’applique à

Voir aussi