ChangeMonitor Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir önbellek öğesinin bağımlı olduğu veri durumundaki değişiklikleri izleyen türetilmiş özel tür için temel bir sınıf sağlar.
public ref class ChangeMonitor abstract : IDisposablepublic abstract class ChangeMonitor : IDisposabletype ChangeMonitor = class
interface IDisposablePublic MustInherit Class ChangeMonitor
Implements IDisposable- Devralma
-
ChangeMonitor
- Türetilmiş
- Uygulamalar
Açıklamalar
ChangeMonitor sınıfı, belirli önbellek uygulamaları için özelleştirilmiş türetilmiş izleyici sınıfları için temel sınıf olarak kullanılır. Bir ChangeMonitor örnek, bir önbellek öğesinin bağımlı olduğu veri durumundaki değişiklikleri izler. Örneğin, öğe içeriği önbelleğe alınmış bir dosya veya veri varlığı olabilir. Dosya veya veri varlığı güncelleştirildiyse, ilişkili önbellek girdisinin de değiştirilmesi gerekir. İzlenebilen yaygın öğeler arasında veri varlıkları (veritabanı alanları, değerler, satırlar veya tablolar gibi), başka bir önbellek girdisi ve dosyalar ve dosya öznitelikleri bulunur.
Bağımlılık değişikliği, bağımlılığın durumundaki bir değişikliktir. Tipik bir önbellek uygulamasında, bir ChangeMonitor örnek önbelleği bir bağımlılığın değiştiğini bildirirse, önbellek eklenen önbellek girişini geçersiz hale getirme gibi gerekli eylemi gerçekleştirir.
Türetilmiş ChangeMonitor sınıflar, belirli farklı veri depoları için bağımlılık değişikliklerini izlemek üzere özelleştirilebilir. Örneğin, bir dosya sistemi, fiziksel bellek veya veritabanı için önbellek uygulamaları vardır. ChangeMonitor sınıfı, önbelleğin dışında gerçekleşen değişiklikleri inceler ve ardından değişikliklerin oluştuğu önbelleği uyarır.
.NET Framework, ChangeMonitor sınıfından türetilen aşağıdaki sınıfları içerir:
Bu sınıfların her biri farklı bağımlılık türleriyle çalışır. Örneğin, türetilmiş FileChangeMonitor sınıf, önbellek öğesinin bağımlı olduğu dosya sistemi verileri (dosyalar ve klasörler) için önbellekteki değişiklikleri izler.
Uygulayanlara Notlar
Özel bir önbellek uygulaması veya türetilmiş bir değişiklik izleyicisi türü oluşturursanız, bazı yönergeleri izlemeniz gerekir. Aşağıdaki listede bu yönergeler özetlemektedir. Daha fazla bilgi için tek tek yöntemlerin veya özelliklerin belgelerine bakın.
Türetilmiş bir sınıfın oluşturucusunun yöntemi döndürmeden önce özelliğini ayarlaması UniqueId , izlemeyi başlatması ve yöntemini çağırması InitializationComplete() gerekir. Oluşturucu, derlemeler sırasında bir hatayla karşılaşırsa ve kaynakları atması gerekiyorsa, oluşturucu yalnızca yöntem çağrıldıktan sonra InitializationComplete() aşırı yüklemeyi çağırabilir Dispose çünkü Dispose başlatma tamamlanmazsa aşırı yükleme bir InvalidOperationException özel durum oluşturur.
Başlatma tamamlanmadan önce izlenen verilerde değişiklikler olursa, oluşturucunun yöntemini çağırmadan önce yöntemini çağırması OnChanged(Object)InitializationComplete() gerekir.
Türetilmiş ChangeMonitor bir tür örneği eklendikten sonra izleyiciyi özel ObjectCache bir uygulamaya eklemeniz gerekir. Veya değişiklik izleyicisini kullanmayı tamamladıysanız yöntemini çağırın Dispose .
Bir örnek bir ChangeMonitorObjectCache uygulamaya eklendikten sonra, ObjectCache değişiklik izleyicisinin atılması gerekir. Ekleme geçersiz olsa ve bir özel duruma neden olsa bile, ObjectCache uygulamanın aşırı yüklemeyi çağırması Dispose gerekir.
Türetilmiş bir değişiklik izleyicisi önbelleğe eklendikten sonra, ObjectCache uygulamanın bir OnChangedCallback nesnesi geçirerek çağrısı NotifyOnChanged(OnChangedCallback)yapması gerekir. NotifyOnChanged(OnChangedCallback) yöntemi yalnızca bir kez çağrılabilir. Bir bağımlılık değişikliği zaten oluştuysa, OnChangedCallback örnek çağrıldığında NotifyOnChanged(OnChangedCallback) hemen çağrılır. Aksi takdirde örnek OnChangedCallback yalnızca bir kez çağrılır. Bu bir kerelik çağrı, örnek bir değişiklik algıladığından OnChanged(Object)ChangeMonitor yöntem çağrıldığında veya yönteminde ChangeMonitorçağrıldığında Dispose() (hangisi önce gerçekleşirse) gerçekleşir.
Bir OnChangedCallbackObjectCache uygulama tarafından sağlanan örnek, ilişkili önbellek girdisini kaldırmalı ve numaralandırmayı DependencyChanged kullanarak bir neden belirtmelidir.
Bir ChangeMonitor örnek, bir önbellek uygulaması yöntemi çağırmadan önce veya sonra yöntemini çağırabilir OnChanged(Object)NotifyOnChanged(OnChangedCallback) . OnChanged(Object) yöntemi çağrılmadan önce NotifyOnChanged(OnChangedCallback) çağrılırsa, temel ChangeMonitor uygulama önbelleğe bunun gerçekleştiğini bildirir ve çağrıldığında NotifyOnChanged(OnChangedCallback) hemen geçirilecek geri çağırmayı NotifyOnChanged(OnChangedCallback) tetikler. yöntemine OnChanged(Object) geçirilen tüm durum verileri, değişiklik izleyicisi tarafından kaydedilir ve ardından yöntem çağrıldığında yöntemine NotifyOnChanged(OnChangedCallback)NotifyOnChanged(OnChangedCallback) geçirilir.
Değişiklik izleyicisi Dispose(Boolean) yöntemini uygulamalıdır. Daha fazla bilgi için yöntem belgelerine Dispose(Boolean) bakın.
Örneği Dispose() atmak ChangeMonitor için yöntem aşırı yüklemesi çağrılmalıdır. Dispose çağrısı için kurallar şunlardır:
Bir öğe önbelleğe eklenmeden önce, bir örneği atmak çağıranın ChangeMonitor sorumluluğundadır.
Önbellek öğesi ve ChangeMonitor onunla ilişkili örnekler önbelleğe geçirildikten sonra, ekleme başarısız olsa bile önbellek uygulayıcısının yöntemin Dispose çağrıldığından emin olması gerekir.
Bir öğe ve ilişkili ChangeMonitor örnekleri önbelleğe geçirildikten sonra, çağıranın bağımlılığı atmaması gerekir çünkü yöntem çağrıldığında Dispose , çağrı bağımlılık değişmiş gibi kabul edilir. Sonuç olarak yöntemi OnChanged(Object) otomatik olarak çağrılır.
Bu kurallar dikkate alındığında yöntemi Dispose aşağıdaki yollardan biriyle çağrılmalıdır:
Kullanıcılar türetilmiş değişiklik izleyicisi örneğini önbelleğe eklememeye karar verirse yöntem aşırı yüklemesini çağırmalıdır Dispose() .
Uygulama change-monitor örneğini bir nesne önbelleğine eklemeye çalışırsa ancak ekleme başarısız olursa, önbellek uygulaması aşırı yüklemeyi çağırmaktan Dispose() sorumludur. Ekleme girişimi bir özel duruma neden olduğunda, önbellek uygulamasının ilişkili bağımlılıkları atması gerekir.
Önbellek girdisi kaldırılırsa, önbellek uygulamasının da bağımlılığı atması gerekir.
yönteminin OnChanged(Object) iç uygulaması, aracılığıyla NotifyOnChanged(OnChangedCallback)kaydedilen bir geri çağırmayı çağırdıktan sonra yöntemini otomatik olarak çağırırDispose.
Not: Olay tetiklenirken dispose yöntemine yapılan bu otomatik çağrı yalnızca örneğin başlatılması ChangeMonitor daha önce tamamlandıysa gerçekleşir.
Türetilmiş bir değişiklik izleyicisinin oluşturucusunun InitializationComplete() yöntemini çağırması durumunda, değişiklik izleyicisinin durumu zaten değişmişse (yani, oluşturucu hala etkinken izlenen durum zaten değişmişse) InitializationComplete() yöntem değişiklik izleyicisini otomatik olarak atacaktır.
-
HasChanged özelliği, bir nesnenin yöntemine OnChanged(Object)
trueçağrı NotifyOnChanged(OnChangedCallback) yapılıp OnChangedCallback yapılmadığına bakılmaksızın türetilmiş change-monitor örneği tarafından çağrıldıktan sonra olarak ayarlanır.
Oluşturucular
| Name | Description |
|---|---|
| ChangeMonitor() |
ChangeMonitor sınıfının yeni bir örneğini başlatır. Bu oluşturucu, temel sınıfı başlatmak için türetilmiş sınıflardaki oluşturuculardan çağrılır. |
Özellikler
| Name | Description |
|---|---|
| HasChanged |
Sınıfı tarafından ChangeMonitor izlenen durumun değiştiğini gösteren bir değer alır. |
| IsDisposed |
Bir sınıfın türetilmiş örneğinin atıldığını gösteren bir ChangeMonitor değer alır. |
| UniqueId |
Sınıf örneğini ChangeMonitor temsil eden bir değer alır. |
Yöntemler
| Name | Description |
|---|---|
| Dispose() |
Sınıfın geçerli örneği ChangeMonitor tarafından kullanılan tüm kaynakları serbest bırakır. |
| Dispose(Boolean) |
Yönetilen ve yönetilmeyen tüm kaynakları ve örneğe yapılan ChangeMonitor başvuruları serbest bırakır. Bu aşırı yükleme, türetilmiş değişiklik izleyici sınıfları tarafından uygulanmalıdır. |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| InitializationComplete() |
Başlatmanın tamamlandığını belirtmek için türetilmiş sınıfların oluşturucusundan çağrılır. |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| NotifyOnChanged(OnChangedCallback) |
Önbellek uygulayıcıları tarafından bir geri çağırma kaydetmek ve bir bağımlılık değiştiğinde ObjectCache temsilci aracılığıyla bir OnChangedCallback örneği bilgilendirmek için çağrılır. |
| OnChanged(Object) |
Bir bağımlılık değiştiğinde olayı yükseltmek için türetilmiş sınıflar tarafından çağrılır. |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
Şunlara uygulanır
İş Parçacığı Güvenliği
Bu tür iş parçacığı güvenlidir.
