ChangeMonitor.NotifyOnChanged(OnChangedCallback) Metode

Definisi

Ruang nama:

System.Runtime.Caching

Rakitan:

System.Runtime.Caching.dll

Paket:

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

Sumber:

ChangeMonitor.cs

Dipanggil oleh pelaksana Cache untuk mendaftarkan panggilan balik dan memberi tahu ObjectCache instans melalui OnChangedCallback delegasi ketika dependensi telah berubah.

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)

Parameter

onChangedCallback

OnChangedCallback

Referensi ke metode yang dipanggil ketika dependensi telah berubah.

Pengecualian

InvalidOperationException

Metode panggilan balik telah dipanggil.

ArgumentNullException

onChangedCallbackadalah null.

Keterangan

Pelaksana cache menggunakan metode ini untuk menyambungkan diri ke monitor perubahan. Jika Anda mengaitkan satu atau beberapa monitor perubahan dengan item cache, Anda meneruskan CacheItemPolicy instans dengan properti monitor perubahan yang diisi ke item cache. Pelaksana cache yang mendukung monitor perubahan bertanggung jawab untuk melakukan iterasi atas ChangeMonitors properti dan mendaftarkan OnChangedCallback delegasi dengan setiap monitor perubahan yang ditemukannya.

OnChangedCallback Karena delegasi menyertakan parameter status opsional, implementasi monitor perubahan konkret dapat meneruskan informasi status opsional. Pelaksana cache menentukan apakah dependensi eksplisit pada jenis status yang diteruskan oleh monitor perubahan kustom sebagai bagian dari panggilan balik dapat diambil.

Catatan

API ekstensibilitas cache dasar tidak memiliki persyaratan untuk dependensi eksplisit pada jenis status.

Implementasi NotifyOnChanged metode secara otomatis menentukan apakah status monitor telah berubah pada metode waktu NotifyOnChanged dipanggil. HasChanged Jika properti adalah true, maka metode secara otomatis memanggil OnChangedCallback penanganan aktivitas, yang terdaftar, melalui OnChanged metode . Ini terjadi karena ada kemungkinan bahwa sejak implementasi cache membuat monitor perubahan, hingga saat implementasi cache mendapatkan monitor dan kabel itu sendiri, status yang dipantau yang mendasarinya telah berubah. Jika status sudah berubah maka objek yang diteruskan ke OnChanged metode adalah null.

Metode ini NotifyOnChanged hanya dapat dipanggil satu kali, dan akan melemparkan pengecualian pada panggilan berikutnya.

Catatan Bagi Inheritor

1. Anda harus memanggil NotifyOnChanged(OnChangedCallback) metode untuk diberi tahu tentang perubahan dependensi apa pun. Jika perubahan dependensi telah terjadi, OnChangedCallback instans akan dipanggil ketika NotifyOnChanged(OnChangedCallback) dipanggil. Jika tidak, OnChangedCallback instans akan dipanggil satu kali, baik ketika OnChanged(Object) metode dipanggil atau ketika Dispose() metode dipanggil, mana pun yang terjadi terlebih dahulu. Instans OnChangedCallback yang disediakan oleh implementasi cache harus menghapus entri cache dan jika diminta oleh penelepon cache, ajukan perubahan yang diperlukan atau perbarui peristiwa kembali ke penelepon cache asli.

2. Implementasi cache objek harus menghapus entri cache yang terkait dengan perubahan dependensi.

Lihat juga

• OnChanged(Object)