DependencyObject.ClearValue Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

WindowsBase.dll

Bir özelliğin yerel değerini temizler.

Aşırı Yüklemeler

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 -> unit

Public Sub ClearValue (dp As DependencyProperty)

Parametreler

dp

DependencyProperty

Temizlenecek bağımlılık özelliği, bir DependencyProperty nesne başvurusu tarafından tanımlanır.

Özel durumlar

InvalidOperationException

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.

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

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 -> unit

Public Sub ClearValue (key As DependencyPropertyKey)

Parametreler

key

DependencyPropertyKey

Bağımlılık özelliğinin temizlenecek anahtarı.

Özel durumlar

InvalidOperationException

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.

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey