DependencyObject.ClearValue Yöntem
Ö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 özelliğin yerel değerini temizler.
| ClearValue(DependencyProperty) |
Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. |
| ClearValue(DependencyPropertyKey) |
Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. |
ClearValue(DependencyProperty)
Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir.
public:
void ClearValue(System::Windows::DependencyProperty ^ dp);public void ClearValue (System.Windows.DependencyProperty dp);member this.ClearValue : System.Windows.DependencyProperty -> unitPublic Sub ClearValue (dp As DependencyProperty)Parametreler
Temizlenecek bağımlılık özelliği, bir DependencyProperty nesne başvurusu tarafından tanımlanır.
Özel durumlar
Korumalı DependencyObjectbir üzerinde çağrısı ClearValue(DependencyProperty) yapmaya çalıştı.
Örnekler
Aşağıdaki örnek, bir nesnede yerel değerleri ayarlanmış olan tüm özellikleri yineler ve ardından bu tür her özelliğin değerlerini temizlemek için çağrı ClearValue yapar.
void RestoreDefaultProperties(object sender, RoutedEventArgs e)
{
UIElementCollection uic = Sandbox.Children;
foreach (Shape uie in uic)
{
LocalValueEnumerator locallySetProperties = uie.GetLocalValueEnumerator();
while (locallySetProperties.MoveNext())
{
DependencyProperty propertyToClear = locallySetProperties.Current.Property;
if (!propertyToClear.ReadOnly) { uie.ClearValue(propertyToClear); }
}
}
}
Private Sub RestoreDefaultProperties(ByVal sender As Object, ByVal e As RoutedEventArgs)
Dim uic As UIElementCollection = Sandbox.Children
For Each uie As Shape In uic
Dim locallySetProperties As LocalValueEnumerator = uie.GetLocalValueEnumerator()
While locallySetProperties.MoveNext()
Dim propertyToClear As DependencyProperty = locallySetProperties.Current.Property
If Not propertyToClear.ReadOnly Then
uie.ClearValue(propertyToClear)
End If
End While
Next
End Sub
Açıklamalar
Çağırarak ClearValue özellik değerini temizlemek, bağımlılık özelliğine bağımlılık özelliği meta verilerinde belirtilen varsayılan değeri vermek zorunda değildir. Özelliğin temizlenmesi yalnızca uygulanmış olabilecek yerel değeri özel olarak temizler. Daha fazla bilgi için bkz . Bağımlılık Özelliği Değer Önceliği.
Ayrıca bkz.
Şunlara uygulanır
.NET Framework 4.8 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |
ClearValue(DependencyPropertyKey)
Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir.
public:
void ClearValue(System::Windows::DependencyPropertyKey ^ key);public void ClearValue (System.Windows.DependencyPropertyKey key);member this.ClearValue : System.Windows.DependencyPropertyKey -> unitPublic Sub ClearValue (key As DependencyPropertyKey)Parametreler
Bağımlılık özelliğinin temizlenecek anahtarı.
Özel durumlar
Korumalı DependencyObjectbir üzerinde çağrısı ClearValue(DependencyProperty) yapmaya çalıştı.
Açıklamalar
, DependencyPropertyKey özellik sistemi işlemleri için salt okunur bağımlılık özelliğini tanımlar. Salt okunur bağımlılık özelliklerini tanımlayan sınıflar bu anahtarı genel erişimle kullanıma sunmamalıdır. Genel kullanıma sunulan bir anahtar, veya gibi ClearValue SetValue yöntemler sınıf veya derleme dışında çağrılabiliyorsa, anahtara başvuruda bulunarak özelliğin salt okunur karakterini olumsuzlayan bir ortak kod yolu sağlar.
Çağırarak ClearValue özellik değerini temizlemek, bağımlılık özelliğine bağımlılık özelliği meta verilerinde belirtilen varsayılan değeri vermek zorunda değildir. Değerin temizlenmesi yalnızca uygulanmış olabilecek yerel değerleri özel olarak temizler. Daha fazla bilgi için bkz . Bağımlılık Özelliği Değer Önceliği.
Ayrıca bkz.
Şunlara uygulanır
.NET Framework 4.8 ve diğer sürümler
| Ürün | Sürümler |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |