Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe WeakEventManager

 

Data di pubblicazione: ottobre 2016

Fornisce una classe base per il gestore di evento che viene utilizzato per la modello di eventi deboli. Il gestore aggiunge e rimuove i listener di eventi (o callback) che utilizzano il modello.

Spazio dei nomi:   System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)


public abstract class WeakEventManager : DispatcherObject

NomeDescrizione
System_CAPS_protmethodWeakEventManager()

Inizializza valori della classe base quando viene utilizzato come inizializzatore dal costruttore di una classe derivata.

NomeDescrizione
System_CAPS_pubpropertyDispatcher

Ottiene il Dispatcher questo DispatcherObject è associato.(Ereditato da DispatcherObject.)

System_CAPS_protpropertyItem[Object]

Ottiene o imposta i dati archiviati per l'origine specificata.

System_CAPS_protpropertyReadLock

Stabilisce un blocco di lettura nella tabella di dati sottostante e restituisce un IDisposable.

System_CAPS_protpropertyWriteLock

Stabilisce un blocco di scrittura nella tabella di dati sottostante e restituisce unIDisposable.

NomeDescrizione
System_CAPS_pubmethodCheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObject.(Ereditato da DispatcherObject.)

System_CAPS_protmethodDeliverEvent(Object, EventArgs)

Recapita l'evento gestito a ogni listener.

System_CAPS_protmethodDeliverEventToList(Object, EventArgs, WeakEventManager.ListenerList)

Recapita l'evento gestito a ogni listener in elenco fornito.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

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.)

System_CAPS_protmethodSystem_CAPS_staticGetCurrentManager(Type)

Restituisce il WeakEventManager implementazione che viene utilizzato per il tipo fornito.

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_protmethodNewListenerList()

Restituisce un nuovo oggetto per contenere i listener per un evento.

System_CAPS_protmethodProtectedAddHandler(Object, Delegate)

Aggiunge il delegato specificato come un gestore eventi dell'origine specificata.

System_CAPS_protmethodProtectedAddListener(Object, IWeakEventListener)

Aggiunge il listener fornito in origine fornito per l'evento gestito.

System_CAPS_protmethodProtectedRemoveHandler(Object, Delegate)

Rimuove il gestore aggiunto in precedenza dall'origine specificata.

System_CAPS_protmethodProtectedRemoveListener(Object, IWeakEventListener)

Rimuove un listener aggiunto in precedenza dall'origine specificata.

System_CAPS_protmethodPurge(Object, Object, Boolean)

Rimuove le voci di listener inattivi dall'elenco dei dati per l'origine specificata. Restituisce true Se alcune voci sono state effettivamente rimosse dall'elenco.

System_CAPS_protmethodRemove(Object)

Rimuove tutti i listener per l'origine specificata.

System_CAPS_protmethodScheduleCleanup()

Richieste che un'eliminazione di voci inutilizzate contenute nell'elenco di listener sottostante deve essere eseguita in un thread con priorità inferiore.

System_CAPS_protmethodSystem_CAPS_staticSetCurrentManager(Type, WeakEventManager)

Imposta il gestore corrente per il tipo di gestione specificato.

System_CAPS_protmethodStartListening(Object)

Quando sottoposto a override in una classe derivata, avvia l'attesa per l'evento gestito. Dopo il StartListening prima chiamata al metodo, il gestore deve essere nello stato della chiamata al metodo DeliverEvent o DeliverEventToList ogni volta che viene gestito l'evento pertinente proveniente dall'origine fornita.

System_CAPS_protmethodStopListening(Object)

Quando sottoposto a override in una classe derivata, interrompe l'ascolto sull'origine fornita per l'evento gestito.

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodVerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObject.(Ereditato da DispatcherObject.)

Generalmente si utilizza il modello di eventi deboli quando l'origine evento abbia una durata dell'oggetto che è indipendente dal listener di eventi. Utilizzo dell'evento centrale dell'invio delle funzionalità di un WeakEventManager consente ai gestori del listener a garbage collection anche se l'oggetto di origine viene mantenuto. Al contrario, un'associazione all'evento regolari utilizzando il += operatore fa sì che l'origine potenzialmente disconnessa mantenere un riferimento di listener di traccia. Ciò impedisce che il destinatario di garbage collection in modo tempestivo.

Una situazione comune in cui è necessario utilizzare le relazioni di durata tra origini e listener del modello di evento debole è la gestione degli eventi di aggiornamento provenienti da associazioni di dati.

Il modello di eventi deboli utilizzabile anche per eventi regolari e i callback.

Note per gli eredi:

Per un esempio di un oggetto personalizzato WeakEventManager, vedere modelli di eventi deboli.

.NET Framework
Disponibile da 3.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: