WeakEventManager WeakEventManager WeakEventManager WeakEventManager Class

Définition

Fournit une classe de base pour le gestionnaire d’événements utilisé dans le modèle d’événement faible.Provides a base class for the event manager that is used in the weak event pattern. Le gestionnaire ajoute et supprime des écouteurs pour les événements (ou rappels) qui utilisent également le modèle.The manager adds and removes listeners for events (or callbacks) that also use the pattern.

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
WeakEventManagerWeakEventManagerWeakEventManagerWeakEventManager
Dérivé

Remarques

En général, vous utilisez le modèle d’événement faible lorsque la source de l’événement a une durée de vie d’objet indépendante des écouteurs d’événements.You typically use the weak event pattern when the event source has an object lifetime that is independent of the event listeners. L’utilisation de la fonctionnalité de distribution des événements centraux d’un WeakEventManager permet aux gestionnaires de l’écouteur d’être récupérés par le garbage collector même si l’objet source persiste.Using the central event dispatching capability of a WeakEventManager allows the listener's handlers to be garbage collected even if the source object persists. En revanche, un raccordement d’événement régulier à += l’aide de l’opérateur entraîne la source potentiellement déconnectée à contenir une référence aux écouteurs.By contrast, a regular event hookup using the += operator causes the potentially disconnected source to hold a reference to the listeners. Cela empêche le récepteur d’être récupéré par le garbage collector en temps opportun.This prevents the receiver from being garbage collected in a timely fashion.

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 des liaisons de données.One common situation where the lifetime relationships between sources and listeners should use of the weak event pattern is the handling of update events coming from data bindings.

Le modèle d’événement faible peut également être utilisé pour les rappels et les événements réguliers.The weak event pattern can also be used for callbacks and regular events.

Notes pour les héritiers

Pour obtenir un exemple de personnalisé WeakEventManager, consultez modèles d’événement faible.For an example of a custom WeakEventManager, see Weak Event Patterns.

Constructeurs

WeakEventManager() WeakEventManager() WeakEventManager() WeakEventManager()

Initialise des valeurs de classe de base en cas d'utilisation comme initialiseur par le constructeur d'une classe dérivée.Initializes base class values when it is used as the initializer by the constructor of a derived class.

Propriétés

Dispatcher Dispatcher Dispatcher Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Item[Object] Item[Object] Item[Object] Item[Object]

Obtient ou définit les données qui sont stockées pour la source spécifiée.Gets or sets the data being stored for the specified source.

ReadLock ReadLock ReadLock ReadLock

Établit un verrou de lecture sur la table de données sous-jacente et retourne un IDisposable.Establishes a read-lock on the underlying data table, and returns an IDisposable.

WriteLock WriteLock WriteLock WriteLock

Établit un verrou d’écriture sur la table de données sous-jacente et retourne un IDisposable.Establishes a write-lock on the underlying data table, and returns an IDisposable.

Méthodes

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
DeliverEvent(Object, EventArgs) DeliverEvent(Object, EventArgs) DeliverEvent(Object, EventArgs) DeliverEvent(Object, EventArgs)

Remet l'événement qui est géré à chaque écouteur.Delivers the event being managed to each listener.

DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList) DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList) DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList) DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList)

Remet l'événement qui est géré à chaque écouteur dans la liste fournie.Delivers the event being managed to each listener in the provided list.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCurrentManager(Type) GetCurrentManager(Type) GetCurrentManager(Type) GetCurrentManager(Type)

Retourne l'implémentation WeakEventManager utilisée pour le type fourni.Returns the WeakEventManager implementation that is used for the provided type.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
NewListenerList() NewListenerList() NewListenerList() NewListenerList()

Retourne un nouvel objet destiné à contenir des écouteurs sur un événement.Returns a new object to contain listeners to an event.

ProtectedAddHandler(Object, Delegate) ProtectedAddHandler(Object, Delegate) ProtectedAddHandler(Object, Delegate) ProtectedAddHandler(Object, Delegate)

Ajoute le délégué spécifié en tant que gestionnaire d'événements de la source spécifiée.Adds the specified delegate as an event handler of the specified source.

ProtectedAddListener(Object, IWeakEventListener) ProtectedAddListener(Object, IWeakEventListener) ProtectedAddListener(Object, IWeakEventListener) ProtectedAddListener(Object, IWeakEventListener)

Ajoute l'écouteur fourni à la source fournie pour l'événement qui est géré.Adds the provided listener to the provided source for the event being managed.

ProtectedRemoveHandler(Object, Delegate) ProtectedRemoveHandler(Object, Delegate) ProtectedRemoveHandler(Object, Delegate) ProtectedRemoveHandler(Object, Delegate)

Supprime de la source spécifiée le gestionnaire ajouté précédemment.Removes the previously added handler from the specified source.

ProtectedRemoveListener(Object, IWeakEventListener) ProtectedRemoveListener(Object, IWeakEventListener) ProtectedRemoveListener(Object, IWeakEventListener) ProtectedRemoveListener(Object, IWeakEventListener)

Supprime un écouteur ajouté précédemment depuis la source fournie.Removes a previously added listener from the provided source.

Purge(Object, Object, Boolean) Purge(Object, Object, Boolean) Purge(Object, Object, Boolean) Purge(Object, Object, Boolean)

Supprime des entrées d'écouteur inactives dans la liste de données pour la source fournie.Removes inactive listener entries from the data list for the provided source. Retourne la valeur true si certaines entrées ont été supprimées réellement de la liste.Returns true if some entries were actually removed from the list.

Remove(Object) Remove(Object) Remove(Object) Remove(Object)

Supprime tous les écouteurs pour la source spécifiée.Removes all listeners for the specified source.

ScheduleCleanup() ScheduleCleanup() ScheduleCleanup() 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é.Requests that a purge of unused entries in the underlying listener list be performed on a lower priority thread.

SetCurrentManager(Type, WeakEventManager) SetCurrentManager(Type, WeakEventManager) SetCurrentManager(Type, WeakEventManager) SetCurrentManager(Type, WeakEventManager)

Définit le gestionnaire actuel pour le type de gestionnaire spécifié.Sets the current manager for the specified manager type.

StartListening(Object) StartListening(Object) StartListening(Object) StartListening(Object)

En cas de substitution dans une classe dérivée, commence à écouter pour l'événement qui est géré.When overridden in a derived class, starts listening for the event being managed. 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é.After the StartListening(Object) method is first called, the manager should be in the state of calling DeliverEvent(Object, EventArgs) or DeliverEventToList(Object, EventArgs, WeakEventManager+ListenerList) whenever the relevant event from the provided source is handled.

StopListening(Object) StopListening(Object) StopListening(Object) 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é.When overridden in a derived class, stops listening on the provided source for the event being managed.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

S’applique à

Voir aussi