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

Im folgenden Beispiel werden alle Eigenschaften durchlaufen, für die lokale Werte für ein-Objekt fest ClearValue gelegt sind. Anschließend wird aufgerufen, um die Werte jeder solchen Eigenschaft zu löschen.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

Das Löschen des Eigenschafts Werts ClearValue durch Aufrufen von weist nicht notwendigerweise eine Abhängigkeits Eigenschaft als Standardwert zu, der in den Metadaten der Abhängigkeits Eigenschaft 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. Durch das Löschen der Eigenschaft wird lediglich der lokale Wert gelöscht, der möglicherweise angewendet wurde.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 identifiziert eine schreibgeschützte Abhängigkeits Eigenschaft für Eigenschaften System Vorgänge.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Klassen, die schreibgeschützte Abhängigkeits Eigenschaften definieren, sollten diesen Schlüssel nicht mit öffentlichem Zugriff verfügbar machen.Classes that define read-only dependency properties should not expose this key with public access. Ein öffentlich verfügbar gemachter Schlüssel stellt einen öffentlichen Codepfad bereit, der das schreibgeschützte Zeichen der-Eigenschaft negiert, wenn Methoden wie ClearValue oder SetValue außerhalb der Klasse oder Assembly aufgerufen werden können, die auf den Schlüssel verweisen.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.

Das Löschen des Eigenschafts Werts ClearValue durch Aufrufen von weist nicht notwendigerweise eine Abhängigkeits Eigenschaft als Standardwert zu, der in den Metadaten der Abhängigkeits Eigenschaft 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. Durch das Löschen des Werts wird lediglich der lokale Wert gelöscht.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: