DependencyObject.ClearValue DependencyObject.ClearValue DependencyObject.ClearValue DependencyObject.ClearValue Method

Definition

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property.

Überlädt

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

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

Die Abhängigkeitseigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Objektverweis identifiziert.The dependency property to be cleared, identified by a DependencyProperty object reference.

Ausnahmen

Beispiele

Das folgende Beispiel durchläuft alle Eigenschaften, die lokalen Werte, die für ein Objekt festgelegt werden ruft dann ClearValue , deaktivieren Sie die Werte dieser Eigenschaften.The following example iterates all properties that have local values set on an object, then calls ClearValue to clear the values of each such property.

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

Löschen den Wert der Eigenschaft durch den Aufruf ClearValue ist nicht zwingend auf einer Abhängigkeitseigenschaft den Standardwert, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist.Clearing the property value by calling ClearValue does not necessarily give a dependency property the default value that is specified in the dependency property metadata. Löschen die Eigenschaft nur speziell löscht der lokaler Wert möglicherweise angewendet wurden.Clearing the property only specifically clears whatever local value may have been applied. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.For more information, see Dependency Property Value Precedence.

Siehe auch

ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a 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 DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

Der Schlüssel für die Abhängigkeitseigenschaft, deren Wert gelöscht werden soll.The key for the dependency property to be cleared.

Ausnahmen

Hinweise

Ein DependencyPropertyKey wird eine schreibgeschützte Abhängigkeitseigenschaft für die Operationen des Eigenschaftensystems identifiziert.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Klassen, die schreibgeschützten Abhängigkeitseigenschaften definieren sollten diesen Schlüssel mit öffentlichem Zugriff nicht verfügbar machen.Classes that define read-only dependency properties should not expose this key with public access. Ein öffentlich verfügbar gemachte Schlüssel würde einen öffentlichen Code-Pfad, der das Zeichen "schreibgeschützt" der Eigenschaft, die negiert bereitstellen, wenn Methoden, z. B. ClearValue oder SetValue außerhalb der Klasse oder Assembly verweisen auf den Schlüssel aufgerufen werden kann.A publicly exposed key would provide a public code pathway that negated the read-only character of the property, if methods such as ClearValue or SetValue could be called outside the class or assembly, referencing the key.

Löschen den Wert der Eigenschaft durch den Aufruf ClearValue ist nicht zwingend auf einer Abhängigkeitseigenschaft den Standardwert, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist.Clearing the property value by calling ClearValue does not necessarily give a dependency property the default value that is specified in the dependency property metadata. Löschen des Werts nur speziell löscht der lokaler Wert möglicherweise angewendet wurden.Clearing the value only specifically clears whatever local value may have been applied. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.For more information, see Dependency Property Value Precedence.

Siehe auch

Gilt für: