Home Library Formazione Code Download Supporto Community Forums
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe WeakEventManager.ListenerList

.NET Framework 4.5

Fornisce un elenco di insiemi incorporati per l'archiviazione dei listener per WeakEventManager.

Spazio dei nomi:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)
XMLNS per XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
C#
C++
F#
VB
Copia 
protected class ListenerList
XAML
Copia 
Non è possibile utilizzare questa classe in XAML.

Il tipo WeakEventManager.ListenerList espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoWeakEventManager.ListenerList()Inizializza una nuova istanza della classe WeakEventManager.ListenerList.
Metodo pubblicoWeakEventManager.ListenerList(Int32)Inizializza una nuova istanza della classe WeakEventManager.ListenerList con la capacità iniziale specificata.
In alto
  NomeDescrizione
Proprietà pubblicaCountOttiene il numero di elementi contenuti nella classe WeakEventManager.ListenerList.
Proprietà pubblicaMembro staticoEmptyOttiene un valore che rappresenta un elenco vuoto per eseguire confronti.
Proprietà pubblicaIsEmptyOttiene un valore che indica se questo WeakEventManager.ListenerList è vuoto.
Proprietà pubblicaItemOttiene o imposta un elemento listener specifico in WeakEventManager.ListenerList.
In alto
  NomeDescrizione
Metodo pubblicoAddAggiunge un oggetto IWeakEventListener all'oggetto WeakEventManager.ListenerList.
Metodo pubblicoAddHandlerAggiunge un gestore eventi per il WeakEventManager.ListenerList.
Metodo pubblicoBeginUseDichiara che l'elenco è in uso. In questo modo si impediscono modifiche dirette all'elenco durante le iterazioni degli elementi dell'elenco.
Metodo pubblicoCloneCrea un clone modificabile per questo WeakEventManager.ListenerList.
Metodo protettoCopyToCopia corrente WeakEventManager.ListenerList specificatoWeakEventManager.ListenerList
Metodo pubblicoDeliverEventOffre l'evento gestito a ogni listener di WeakEventManager.ListenerList.
Metodo pubblicoEndUseAnnulla lo stato di blocco iniziato da BeginUse.
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoGetHashCodeFunge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo protettoMemberwiseCloneConsente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoMembro staticoPrepareForWritingControlla 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.
Metodo pubblicoPurgeRimuove tutte le voci dall'elenco in cui la destinazione di riferimento sottostante sia un riferimento null.
Metodo pubblicoRemoveRimuove la prima occorrenza di un elemento listener da WeakEventManager.ListenerList.
Metodo pubblicoRemoveHandlerRimuove un gestore eventi dal WeakEventManager.ListenerList.
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
In alto

Anche se in questo elenco sono contenuti dei membri simili a quelli definiti dagli oggetti IList e ICollection e vengono fornite funzionalità analoghe, questa classe non implementa nessune di tali interfacce.

La maggior parte delle classi derivate WeakEventManager non richiede l'utilizzo di alcun membro di WeakEventManager.ListenerList. I metodi WeakEventManagerProtectedAddListener e ProtectedRemoveListener utilizzano internamente un oggetto WeakEventManager.ListenerList predefinito, un elenco per ogni oggetto source.

È sufficiente chiamare i metodi WeakEventManager.ListenerList se la classe WeakEventManager gestisce più elenchi per la stessa combinazione di origini eventi, con ciascun elenco creato per soddisfare condizioni diverse dell'evento. In questo caso, non si utilizzano i metodi ProtectedAddListener e ProtectedRemoveListener ed è invece necessario implementare AddListener o RemoveListener per eseguire azioni sui listener di uno soltanto degli elenchi di listener interni, in genere in base a un parametro che viene aggiunto a AddListener o RemoveListener. Inoltre, non è sufficiente che l'implementazione del gestore che riceve l'evento non elaborato chiami DeliverEvent; è necessario invece tenere traccia delle specifiche dell'evento e inviare l'evento solo all'elenco appropriato tramite DeliverEventToList.

Vengono forniti vari metodi di WeakEventManager.ListenerList in modo da utilizzare gli elenchi interni per impedire le modifiche dell'elenco quando l'evento viene effettivamente inviato.

Una classe di esempio che utilizza questa tecnica di implementazione è PropertyChangedEventManager, che gestisce elenchi di listener separati per PropertyChanged, a seconda di quali proprietà sono state modificate.

.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.