WeakEventManager 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 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::DispatcherObjectpublic abstract class WeakEventManager : System.Windows.Threading.DispatcherObjecttype WeakEventManager = class
inherit DispatcherObjectPublic MustInherit Class WeakEventManager
Inherits DispatcherObject- Héritage
- 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 |
| 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) |
