DependencyObject.ClearValue Yöntem

Tanım

Bir özelliğin yerel değerini temizler.

Aşırı Yüklemeler

Name Description
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şvurusuyla tanımlanır.

Özel durumlar

Korumalı ClearValue(DependencyProperty)bir üzerinde çağrısı DependencyObject yapmaya çalıştı.

Örnekler

Aşağıdaki örnek, bir nesnede yerel değerleri ayarlanmış 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ği meta verilerinde belirtilen varsayılan değeri mutlaka bir bağımlılık özelliğine vermez. Özelliğin temizlenmesi, yalnızca uygulanmış olabilecek yerel değerleri özel olarak temizler. Daha fazla bilgi için bkz . Bağımlılık Özellik Değeri Önceliği.

Ayrıca bkz.

Şunlara uygulanır

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

Temizlenecek bağımlılık özelliğinin anahtarı.

Özel durumlar

Korumalı ClearValue(DependencyProperty)bir üzerinde çağrısı DependencyObject 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 ClearValueSetValue yöntemler sınıfın veya derlemenin 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ği meta verilerinde belirtilen varsayılan değeri mutlaka bir bağımlılık özelliğine vermez. Değerin temizlenmesi yalnızca uygulanmış olabilecek yerel değerleri temizler. Daha fazla bilgi için bkz . Bağımlılık Özellik Değeri Önceliği.

Ayrıca bkz.

Şunlara uygulanır