DependencyObject.ClearValue Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

WindowsBase.dll

Menghapus nilai lokal properti.

Overload

ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi.
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey.

ClearValue(DependencyProperty)

Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi.

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)

Parameter

dp

DependencyProperty

Properti dependensi yang akan dibersihkan, diidentifikasi oleh DependencyProperty referensi objek.

Pengecualian

InvalidOperationException

Mencoba memanggil ClearValue(DependencyProperty) pada tertutup DependencyObject.

Contoh

Contoh berikut mengurai semua properti yang memiliki nilai lokal yang diatur pada objek, lalu memanggil ClearValue untuk menghapus nilai setiap properti tersebut.

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

Keterangan

Menghapus nilai properti dengan memanggil ClearValue tidak selalu memberikan properti dependensi nilai default yang ditentukan dalam metadata properti dependensi. Menghapus properti hanya secara khusus menghapus nilai lokal apa pun yang mungkin telah diterapkan. Untuk informasi selengkapnya, lihat Prioritas Nilai Properti Dependensi.

Lihat juga

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey.

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)

Parameter

key

DependencyPropertyKey

Kunci untuk properti dependensi yang akan dibersihkan.

Pengecualian

InvalidOperationException

Mencoba memanggil ClearValue(DependencyProperty) pada tertutup DependencyObject.

Keterangan

DependencyPropertyKey Mengidentifikasi properti dependensi baca-saja untuk operasi sistem properti. Kelas yang menentukan properti dependensi baca-saja tidak boleh mengekspos kunci ini dengan akses publik. Kunci yang diekspos secara publik akan menyediakan jalur kode publik yang meniadakan karakter baca-saja properti, jika metode seperti ClearValue atau SetValue dapat dipanggil di luar kelas atau perakitan, merujuk kunci.

Menghapus nilai properti dengan memanggil ClearValue tidak selalu memberikan properti dependensi nilai default yang ditentukan dalam metadata properti dependensi. Menghapus nilai hanya secara khusus menghapus nilai lokal apa pun yang mungkin telah diterapkan. Untuk informasi selengkapnya, lihat Prioritas Nilai Properti Dependensi.

Lihat juga

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey