ChangeMonitor.NotifyOnChanged(OnChangedCallback) Metodo
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.
Chiamato dagli implementatori della cache per registrare un callback e notificare a un'istanza ObjectCache tramite il OnChangedCallback delegato quando una dipendenza è cambiata.
public:
void NotifyOnChanged(System::Runtime::Caching::OnChangedCallback ^ onChangedCallback);public void NotifyOnChanged(System.Runtime.Caching.OnChangedCallback onChangedCallback);member this.NotifyOnChanged : System.Runtime.Caching.OnChangedCallback -> unitPublic Sub NotifyOnChanged (onChangedCallback As OnChangedCallback)Parametri
- onChangedCallback
- OnChangedCallback
Riferimento a un metodo richiamato quando una dipendenza è stata modificata.
Eccezioni
Il metodo di callback è già stato richiamato.
onChangedCallback è null.
Commenti
Gli implementatori della cache usano questo metodo per collegarsi a un monitoraggio delle modifiche. Se si associano uno o più monitoraggi delle modifiche all'elemento della cache, si passa un'istanza CacheItemPolicy a una proprietà di monitoraggi delle modifiche popolata all'elemento della cache. Un implementatore della cache che supporta i monitoraggi delle modifiche è responsabile dell'iterazione sulla ChangeMonitors proprietà e registrare i OnChangedCallback delegati con ogni monitoraggio delle modifiche trovato.
Poiché il OnChangedCallback delegato include un parametro di stato facoltativo, un'implementazione concreta di Monitoraggio modifiche può passare informazioni facoltative sullo stato. L'implementatore della cache determina se è possibile eseguire una dipendenza esplicita dal tipo di stato passato da un monitoraggio modifiche personalizzato come parte del callback.
Annotazioni
L'API di estendibilità della cache di base non ha alcun requisito per la dipendenza esplicita dal tipo di stato.
L'implementazione del NotifyOnChanged metodo determina automaticamente se lo stato del monitoraggio è già stato modificato al momento NotifyOnChanged della chiamata al metodo . Se la HasChanged proprietà è true, il metodo chiama automaticamente il OnChangedCallback gestore eventi, registrato tramite il OnChanged metodo . Ciò si verifica perché è possibile che, dal momento in cui un'implementazione della cache crea un monitoraggio delle modifiche, al momento in cui un'implementazione della cache ottiene il monitoraggio e si collega a essa, lo stato monitorato sottostante è cambiato. Se lo stato è già stato modificato, l'oggetto passato al OnChanged metodo è null.
Il NotifyOnChanged metodo può essere richiamato una sola volta e genererà un'eccezione nelle chiamate successive.
Note per gli eredi
È necessario chiamare il NotifyOnChanged(OnChangedCallback) metodo per ricevere una notifica di eventuali modifiche alle dipendenze. Se si è già verificata una modifica delle dipendenze, l'istanza OnChangedCallback verrà chiamata quando NotifyOnChanged(OnChangedCallback) viene chiamato . In caso contrario, l'istanza OnChangedCallback verrà chiamata una volta, quando viene chiamato il OnChanged(Object) metodo o quando viene chiamato il Dispose() metodo, a qualsiasi condizione si verifichi per prima. L'istanza OnChangedCallback fornita dall'implementazione della cache deve rimuovere la voce della cache e, se richiesta dal chiamante della cache, generare la modifica o aggiornare l'evento necessario al chiamante della cache originale.
L'implementazione della cache degli oggetti deve rimuovere la voce della cache associata a una modifica delle dipendenze.
