WeakEventManager.ListenerList Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un elenco di insiemi incorporati per l'archiviazione dei listener per WeakEventManager.
protected: ref class WeakEventManager::ListenerListprotected class WeakEventManager.ListenerListProtected Class WeakEventManager.ListenerList- Ereditarietà
-
WeakEventManager.ListenerList
- Derivato
Commenti
Anche se questo elenco contiene membri simili a quelli definiti da IList e ICollectione forniscono funzionalità simili, questa classe implementa nessuna di queste interfacce.
La maggior parte delle WeakEventManager classi derivate non deve usare alcun membro in WeakEventManager.ListenerList. I WeakEventManager metodi ProtectedAddListener e ProtectedRemoveListener usano un valore predefinito internamente WeakEventManager.ListenerList , un elenco per ogni sourceoggetto .
È sufficiente chiamare WeakEventManager.ListenerList i metodi se la WeakEventManager classe mantiene più elenchi per la stessa combinazione di origine evento, con ogni elenco creato per tenere conto di condizioni diverse dell'evento. In questo caso, non si userebbe ProtectedAddListener e e ProtectedRemoveListener si implementerebbe AddListener o RemoveListener per agire su listener solo in uno degli elenchi di listener interni, in genere in base a un parametro aggiunto a AddListener o RemoveListener. Inoltre, l'implementazione del gestore che riceve l'evento non elaborato non può semplicemente chiamare DeliverEvent. È invece necessario tenere traccia delle specifiche dell'evento e recapitare l'evento solo all'elenco appropriato usando DeliverEventToList.
I vari metodi di WeakEventManager.ListenerList vengono forniti in modo da poter lavorare con gli elenchi interni e in modo da impedire la modifica dell'elenco durante il recapito effettivo dell'evento.
Una classe di esempio che usa questa tecnica di implementazione è PropertyChangedEventManager, che gestisce elenchi listener separati per PropertyChanged in base alla proprietà modificata.
Utilizzo del testo XAML
Non è possibile usare questa classe in XAML.
Costruttori
| WeakEventManager.ListenerList() |
Inizializza una nuova istanza della classe WeakEventManager.ListenerList. |
| WeakEventManager.ListenerList(Int32) |
Inizializza una nuova istanza della classe WeakEventManager.ListenerList con la capacità iniziale specificata. |
Proprietà
| Count |
Ottiene il numero di elementi contenuti nella classe WeakEventManager.ListenerList. |
| Empty |
Ottiene un valore che rappresenta un elenco vuoto per eseguire confronti. |
| IsEmpty |
Ottiene un valore che dichiara se questo oggetto WeakEventManager.ListenerList è vuoto. |
| Item[Int32] |
Ottiene o imposta un elemento listener specifico in WeakEventManager.ListenerList. |
Metodi
| Add(IWeakEventListener) |
Aggiunge un oggetto IWeakEventListener a WeakEventManager.ListenerList. |
| AddHandler(Delegate) |
Aggiunge un gestore eventi all'oggetto WeakEventManager.ListenerList. |
| BeginUse() |
Dichiara che l'elenco è in uso. In questo modo si impediscono modifiche dirette all'elenco durante le iterazioni degli elementi dell'elenco. |
| Clone() |
Crea un duplicato modificabile di WeakEventManager.ListenerList. |
| CopyTo(WeakEventManager+ListenerList) |
Copia l'oggetto corrente WeakEventManager.ListenerList nell'oggetto specificato WeakEventManager.ListenerList. |
| DeliverEvent(Object, EventArgs, Type) |
Recapita l'evento gestito a ogni listener in WeakEventManager.ListenerList. |
| EndUse() |
Annulla lo stato di blocco iniziato da BeginUse(). |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| PrepareForWriting(WeakEventManager+ListenerList) |
Controlla se l'elenco fornito è in uso e, in caso affermativo, imposta un parametro di riferimento dell'elenco su una copia di quell'elenco anziché sull'originale. |
| Purge() |
Rimuove tutte le voci dall'elenco in cui la destinazione di riferimento sottostante sia un riferimento null. |
| Remove(IWeakEventListener) |
Rimuove la prima occorrenza di un elemento listener da WeakEventManager.ListenerList. |
| RemoveHandler(Delegate) |
Rimuove un gestore eventi da WeakEventManager.ListenerList. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |