WeakEventManager Classe

  • Référence

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 d’événements centrale d’un WeakEventManager permet aux gestionnaires de l’écouteur d’être collectés à la mémoire même si l’objet source persiste. En revanche, une connexion d’événements régulière à l’aide de l’opérateur += fait que la source potentiellement déconnectée contient une référence aux écouteurs. Cela empêche le récepteur d’être ramassé en temps opportun.

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 d’un personnalisé WeakEventManager, consultez Modèles d’événements faibles.

Constructeurs

WeakEventManager()

Initialise des valeurs de classe de base en cas d'utilisation comme initialiseur par le constructeur d'une classe dérivée.

Propriétés

Dispatcher

Obtient le Dispatcher associé à DispatcherObject.

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

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

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

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

Méthodes

CheckAccess()

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

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

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

Remet l'événement qui est 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()

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)
NewListenerList()

Retourne un nouvel objet destiné à contenir des écouteurs sur 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 qui est géré.
ProtectedRemoveHandler(Object, Delegate)

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

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

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

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

Demande qu'un vidage d'entrées inutilisées dans la liste d'écouteur sous-jacente soit effectué sur un thread de basse priorité.
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 pour l'événement qui est géré. Après avoir d'abord appelé la méthode StartListening(Object), le gestionnaire doit être dans l'état d'appeler 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, cesse d'écouter sur la source fournie pour l'événement qui est géré.
ToString()

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

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.

(Hérité de DispatcherObject)

S’applique à

Voir aussi