DependencyObject.ClearValue Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

WindowsBase.dll

Czyści wartość lokalną właściwości.

Przeciążenia

ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator.
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element DependencyPropertyKey.

ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator.

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)

Parametry

dp

DependencyProperty

Właściwość zależności, która ma zostać wyczyszczone, identyfikowana przez DependencyProperty odwołanie do obiektu.

Wyjątki

InvalidOperationException

Podjęto próbę wywołania ClearValue(DependencyProperty) zapieczętowanego DependencyObjectelementu .

Przykłady

W poniższym przykładzie iteruje wszystkie właściwości, które mają wartości lokalne ustawione dla obiektu, a następnie wywołuje metodę ClearValue w celu wyczyszczenia wartości każdej takiej właściwości.

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

Uwagi

Wyczyszczenie wartości właściwości przez wywołanie ClearValue metody niekoniecznie powoduje nadanie właściwości zależności wartości domyślnej określonej w metadanych właściwości zależności. Wyczyszczenie właściwości powoduje tylko wyczyszczenie wartości lokalnej, która mogła zostać zastosowana. Aby uzyskać więcej informacji, zobacz Pierwszeństwo wartości właściwości zależności.

Zobacz też

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez element 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)

Parametry

key

DependencyPropertyKey

Klucz właściwości zależności do wyczyszczenia.

Wyjątki

InvalidOperationException

Podjęto próbę wywołania ClearValue(DependencyProperty) zapieczętowanego DependencyObjectelementu .

Uwagi

Obiekt DependencyPropertyKey identyfikuje właściwość zależności tylko do odczytu dla operacji systemu właściwości. Klasy definiujące właściwości zależności tylko do odczytu nie powinny ujawniać tego klucza z dostępem publicznym. Publicznie uwidoczniony klucz zapewni ścieżkę kodu publicznego, która zanegowała znak tylko do odczytu właściwości, jeśli metody takie jak ClearValue lub SetValue mogą być wywoływane poza klasą lub zestawem, odwołując się do klucza.

Wyczyszczenie wartości właściwości przez wywołanie ClearValue metody niekoniecznie powoduje nadanie właściwości zależności wartości domyślnej określonej w metadanych właściwości zależności. Wyczyszczenie wartości powoduje tylko wyczyszczenie wartości lokalnej, która mogła zostać zastosowana. Aby uzyskać więcej informacji, zobacz Pierwszeństwo wartości właściwości zależności.

Zobacz też

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey