ChangeMonitor.NotifyOnChanged(OnChangedCallback) Metoda

Definicja

Przestrzeń nazw:

System.Runtime.Caching

Zestaw:

System.Runtime.Caching.dll

Pakiet:

System.Runtime.Caching v9.0.0-preview.5.24306.7

Źródło:

ChangeMonitor.cs

Wywoływane przez implementatory pamięci podręcznej do rejestrowania wywołania zwrotnego i powiadamiania ObjectCache wystąpienia za pośrednictwem OnChangedCallback delegata, gdy zależność uległa zmianie.

public:
 void NotifyOnChanged(System::Runtime::Caching::OnChangedCallback ^ onChangedCallback);

public void NotifyOnChanged (System.Runtime.Caching.OnChangedCallback onChangedCallback);

member this.NotifyOnChanged : System.Runtime.Caching.OnChangedCallback -> unit

Public Sub NotifyOnChanged (onChangedCallback As OnChangedCallback)

Parametry

onChangedCallback

OnChangedCallback

Odwołanie do metody wywoływanej po zmianie zależności.

Wyjątki

InvalidOperationException

Wywołanie metody wywołania zwrotnego zostało już wywołane.

ArgumentNullException

onChangedCallback to null.

Uwagi

Implementatory pamięci podręcznej używają tej metody, aby połączyć się z monitorem zmian. Jeśli skojarzysz co najmniej jeden monitor zmian z elementem pamięci podręcznej, przekażesz CacheItemPolicy wystąpienie z wypełniona właściwość monitora zmian do elementu pamięci podręcznej. Implementator pamięci podręcznej, który obsługuje monitory zmian, jest odpowiedzialny za iterowanie ChangeMonitors właściwości i rejestrowanie delegatów przy użyciu każdego znalezionego OnChangedCallback monitora zmian.

OnChangedCallback Ponieważ delegat zawiera opcjonalny parametr stanu, konkretna implementacja monitora zmian może przekazywać opcjonalne informacje o stanie. Implementator pamięci podręcznej określa, czy można podjąć jawną zależność od typu stanu, który może zostać przeniesiony przez niestandardowy monitor zmian w ramach wywołania zwrotnego.

Uwaga

Podstawowy interfejs API rozszerzalności pamięci podręcznej nie wymaga jawnej zależności od typu stanu.

Implementacja NotifyOnChanged metody automatycznie określa, czy stan monitora został już zmieniony w metodzie czasu NotifyOnChanged . HasChanged Jeśli właściwość ma truewartość , metoda automatycznie wywołuje procedurę OnChangedCallback obsługi zdarzeń, która została zarejestrowana OnChanged za pośrednictwem metody . Dzieje się tak, ponieważ istnieje możliwość, że od momentu utworzenia monitora zmian przez implementację pamięci podręcznej do czasu, gdy implementacja pamięci podręcznej pobiera monitor i podłącza się do niego, stan monitorowany został zmieniony. Jeśli stan został już zmieniony, obiekt, który jest przekazywany do OnChanged metody, to null.

Metodę NotifyOnChanged można wywołać tylko raz i zgłosi wyjątek w kolejnych wywołaniach.

Uwagi dotyczące dziedziczenia

1. Należy wywołać metodę NotifyOnChanged(OnChangedCallback) , aby powiadomić o wszelkich zmianach zależności. Jeśli nastąpiła już zmiana zależności, OnChangedCallback wystąpienie zostanie wywołane po NotifyOnChanged(OnChangedCallback) wywołaniu. OnChangedCallback W przeciwnym razie wystąpienie zostanie wywołane jednorazowo, gdy OnChanged(Object) zostanie wywołana metoda lub gdy Dispose() metoda zostanie wywołana, w zależności od tego, co nastąpi wcześniej. Wystąpienie OnChangedCallback udostępnione przez implementację pamięci podręcznej powinno usunąć wpis pamięci podręcznej, a jeśli jest żądane przez obiekt wywołujący pamięć podręczną, zgłoś niezbędne zmiany lub zaktualizuj zdarzenie z powrotem do oryginalnego obiektu wywołującego pamięć podręczną.

2. Implementacja pamięci podręcznej obiektów musi usunąć wpis pamięci podręcznej skojarzony ze zmianą zależności.

Zobacz też

• OnChanged(Object)