Freezable 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.
Değiştirilebilir duruma ve salt okunur (dondurulmuş) duruma sahip bir nesneyi tanımlar. 'den Freezable türetilen sınıflar ayrıntılı değişiklik bildirimi sağlar, sabit hale getirilebilir ve kendilerini kopyalayabilir.
public ref class Freezable abstract : System::Windows::DependencyObjectpublic abstract class Freezable : System.Windows.DependencyObjecttype Freezable = class
inherit DependencyObjectPublic MustInherit Class Freezable
Inherits DependencyObject- Devralma
- Türetilmiş
Açıklamalar
sınıfı, Freezable değiştirilmesi veya kopyalanması pahalı nesneleri kullanırken uygulama performansını iyileştirmeye yardımcı olabilecek özel özellikler sağlar. Nesne örnekleri Freezable şunlardır:
Freezable'dan Türetme
öğesinden Freezable türetilen bir sınıf aşağıdaki özellikleri kazanır:
Özel durumlar: salt okunur (dondurulmuş) durum ve yazılabilir durum.
İş parçacığı güvenliği: Dondurulmuş Freezable bir nesne iş parçacıkları arasında paylaşılabilir.
Ayrıntılı değişiklik bildirimi: Diğer DependencyObject nesnelerden farklı olarak Freezable , alt özellik değerleri değiştiğinde nesne değişiklik bildirimleri sağlar.
Kolay kopyalama: Freezable sınıfı zaten derin klonlar üreten çeşitli yöntemler uygulamıştır.
Kendi Freezable nesnelerinizi kullanma ve oluşturma hakkında bilgi için bkz . Freezable Objects Overview.
Oluşturucular
| Name | Description |
|---|---|
| Freezable() |
Türetilmiş bir sınıfın yeni bir Freezable örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| CanFreeze |
Nesnenin değiştirilemez hale getirilip getirilemeyeceğini gösteren bir değer alır. |
| DependencyObjectType |
DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject) |
| Dispatcher |
Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject) |
| IsFrozen |
Nesnenin şu anda değiştirilebilir olup olmadığını gösteren bir değer alır. |
| IsSealed |
Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject) |
Yöntemler
| Name | Description |
|---|---|
| CheckAccess() |
Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject) |
| ClearValue(DependencyProperty) |
Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. (Devralındığı yer: DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. (Devralındığı yer: DependencyObject) |
| Clone() |
Freezabledeğiştirilebilir bir kopyasını oluşturur ve nesnenin değerlerinin derin kopyalarını oluşturur. Nesnenin bağımlılık özelliklerini kopyalarken, bu yöntem ifadeleri (artık çözümlenmeyebilir) kopyalar, ancak animasyonları veya geçerli değerlerini kopyalar. |
| CloneCore(Freezable) |
Temel (animasyonsuz) özellik değerlerini kullanarak örneği belirtilenlerin Freezable bir kopyası (derin kopya) yapar. |
| CloneCurrentValue() |
Geçerli değerlerini kullanarak öğesinin Freezable değiştirilebilir bir kopyasını (derin kopya) oluşturur. |
| CloneCurrentValueCore(Freezable) |
Geçerli özellik değerlerini kullanarak örneği belirtilenlerin Freezable değiştirilebilir bir kopyası (derin kopya) yapar. |
| CoerceValue(DependencyProperty) |
Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında CoerceValueCallbackvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir DependencyObject işlevi çağırarak gerçekleştirilir. (Devralındığı yer: DependencyObject) |
| CreateInstance() |
Freezable sınıfının yeni bir örneğini başlatır. |
| CreateInstanceCore() |
Türetilmiş bir sınıfta uygulandığında, türetilmiş sınıfın Freezable yeni bir örneğini oluşturur. |
| Equals(Object) |
Sağlanan DependencyObject öğesinin geçerli DependencyObjectile eşdeğer olup olmadığını belirler. (Devralındığı yer: DependencyObject) |
| Freeze() |
Geçerli nesneyi değiştirilemez hale getirir ve özelliğini olarak IsFrozenayarlar |
| Freeze(Freezable, Boolean) |
|
| FreezeCore(Boolean) |
Freezable Nesneyi değiştirilemez hale getirir veya değiştirilemez hale getirilip getirilemeyeceğini test eder. |
| GetAsFrozen() |
temel (animasyonsuz) özellik değerlerini kullanarak donmuş bir kopyasını Freezableoluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. |
| GetAsFrozenCore(Freezable) |
Temel (animasyonsuz) özellik değerlerini kullanarak örneği belirtilenlerin Freezable donmuş bir kopyası yapar. |
| GetCurrentValueAsFrozen() |
Geçerli özellik değerlerini kullanarak donmuş Freezable bir kopyasını oluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. |
| GetCurrentValueAsFrozenCore(Freezable) |
Geçerli örneği, belirtilen Freezableöğesinin donmuş bir kopyası yapar. Nesne animasyonlu bağımlılık özelliklerine sahipse, geçerli animasyonlu değerleri kopyalanır. |
| GetHashCode() |
Bu DependencyObjectiçin bir karma kodu alır. (Devralındığı yer: DependencyObject) |
| GetLocalValueEnumerator() |
Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özel bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject) |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| GetValue(DependencyProperty) |
Bir öğesinin bu örneğindeki bir bağımlılık özelliğinin DependencyObjectgeçerli etkin değerini döndürür. (Devralındığı yer: DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir. (Devralındığı yer: DependencyObject) |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| OnChanged() |
Geçerli Freezable nesne değiştirildiğinde çağrılır. |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır. |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Yeni ayarlanmış bir DependencyObjectType veri üyesi için uygun bağlam işaretçilerinin oluşturulmasını sağlar. |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
türündeki DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs)değişen bağımlılık özelliğine yanıt olarak herhangi Changed bir işleyici çağırmak için uygulamasını Freezable geçersiz kılar. |
| ReadLocalValue(DependencyProperty) |
Varsa, bağımlılık özelliğinin yerel değerini döndürür. (Devralındığı yer: DependencyObject) |
| ReadPreamble() |
Freezable geçerli bir iş parçacığından erişildiğinden emin olur. öğesinin Freezable devralanları, bağımlılık özellikleri olmayan veri üyelerini okuyan herhangi bir API'nin başında bu yöntemi çağırmalıdır. |
| SetCurrentValue(DependencyProperty, Object) |
Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar. (Devralındığı yer: DependencyObject) |
| SetValue(DependencyProperty, Object) |
Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar. (Devralındığı yer: DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Serileştirme işlemlerinin sağlanan bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini gösteren bir değer döndürür. (Devralındığı yer: DependencyObject) |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
| VerifyAccess() |
Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject) |
| WritePostscript() |
Changed için Freezable olayını oluşturur ve yöntemini çağırırOnChanged(). öğesinden Freezable türetilen sınıflar, bağımlılık özellikleri olarak depolanmayan sınıf üyelerini değiştiren herhangi bir API'nin sonunda bu yöntemi çağırmalıdır. |
| WritePreamble() |
öğesinin Freezable dondurulmadığını ve geçerli bir iş parçacığı bağlamından erişildiğini doğrular. Freezable devralanların, bağımlılık özellikleri olmayan veri üyelerine yazan herhangi bir API'nin başında bu yöntemi çağırması gerekir. |
Ekinlikler
| Name | Description |
|---|---|
| Changed |
veya içerdiği bir nesne değiştirildiğinde Freezable gerçekleşir. |
Şunlara uygulanır
İş Parçacığı Güvenliği
Bu türün tüm genel static üyeleri iş parçacığı güvenlidir. Hiçbir örnek üyesi için iş parçacığı güvenliği garanti edilmez.
IsFrozen özelliği olduğundafalse, bir Freezable nesneye yalnızca oluşturulduğu iş parçacığından erişilebilir. Başka bir iş parçacığından erişmeye çalışılması bir InvalidOperationExceptionoluşturur.
Invoke ve BeginInvoke yöntemleri, doğru iş parçacığına hazırlama desteği sağlar.
Özellikleri IsFrozen olduğunda true, Freezable nesneler serbest iş parçacıklıdır. Daha fazla bilgi için bkz. Dondurulabilir Nesneler Genel Bakış.
