Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DependencyObject.ClearValue-Methode: (DependencyProperty)

 

Veröffentlicht: Oktober 2016

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

Namespace:   System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public void ClearValue(
	DependencyProperty dp
)

Parameter

dp
Type: System.Windows.DependencyProperty

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

Exception Condition
InvalidOperationException

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

Clearing the property value by calling M:System.Windows.DependencyObject.ClearValue(System.Windows.DependencyProperty) does not necessarily give a dependency property the default value that is specified in the dependency property metadata. Clearing the property only specifically clears whatever local value may have been applied. For more information, see Dependency Property Value Precedence.

The following example iterates all properties that have local values set on an object, then calls M:System.Windows.DependencyObject.ClearValue(System.Windows.DependencyProperty) 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); }
        }
    }
}

.NET Framework
Verfügbar seit 3.0
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Zurück zum Anfang
Anzeigen: