DependencyObject.ClearValue Methode

Definition

Löscht den lokalen Wert einer Eigenschaft.

Überlädt

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.

ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.

ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.

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

Die Abhängigkeitseigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Objektverweis identifiziert.

Ausnahmen

Es wurde versucht, ClearValue(DependencyProperty) für ein versiegeltes DependencyObject aufzurufen.

Beispiele

Im folgenden Beispiel werden alle Eigenschaften, die lokale Werte für ein Objekt festgelegt haben, aktualisiert und anschließend aufgerufen ClearValue , um die Werte jeder solchen Eigenschaft zu löschen.

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

Hinweise

Das Löschen des Eigenschaftswerts durch Aufrufen ClearValue gibt nicht unbedingt einer Abhängigkeitseigenschaft den Standardwert, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist. Das Löschen der Eigenschaft löscht nur den lokalen Wert, der möglicherweise angewendet wurde. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.

Siehe auch

Gilt für:

ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.

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

Der Schlüssel für die Abhängigkeitseigenschaft, deren Wert gelöscht werden soll.

Ausnahmen

Es wurde versucht, ClearValue(DependencyProperty) für ein versiegeltes DependencyObject aufzurufen.

Hinweise

A DependencyPropertyKey identifies a read-only dependency property for property system operations. Klassen, die schreibgeschützte Abhängigkeitseigenschaften definieren, sollten diesen Schlüssel nicht mit öffentlichem Zugriff verfügbar machen. Ein öffentlich verfügbar gemachter Schlüssel würde einen öffentlichen Codepfad bereitstellen, der das schreibgeschützte Zeichen der Eigenschaft negierte, wenn Methoden wie ClearValue SetValue z. B. außerhalb der Klasse oder Assembly aufgerufen werden könnten, um auf den Schlüssel zu verweisen.

Das Löschen des Eigenschaftswerts durch Aufrufen ClearValue gibt nicht unbedingt einer Abhängigkeitseigenschaft den Standardwert, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist. Durch das Löschen des Werts wird nur der lokale Wert gelöscht, der möglicherweise angewendet wurde. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.

Siehe auch

Gilt für: