Informationen
Das angeforderte Thema wird unten angezeigt. Es ist jedoch nicht in dieser Bibliothek vorhanden.

DependencyObject.ClearValue-Methode (DependencyProperty)

Aktualisiert: November 2007

Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben.

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

public void ClearValue(
	DependencyProperty dp
)
public void ClearValue(
	DependencyProperty dp
)
public function ClearValue(
	dp : DependencyProperty
)
Sie können diese Methoden nicht in XAML verwenden.

Parameter

dp
Typ: System.Windows.DependencyProperty
Die zu löschende Abhängigkeitseigenschaft, die über einen DependencyProperty-Objektverweis identifiziert wird.

AusnahmeBedingung
InvalidOperationException

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

Beim Löschen des Eigenschaftenwerts mit der ClearValue-Methode wird eine Abhängigkeitseigenschaft nicht zwingend auf den Standardwert festgelegt, der in den Metadaten der Abhängigkeitseigenschaft angegeben ist. Durch das Löschen der Eigenschaft wird lediglich der aktuell zugewiesene lokale Wert gelöscht. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftenwerten.

Im folgenden Beispiel werden alle Eigenschaften durchlaufen, für die in einem Objekt lokale Werte festgelegt wurden, und die Werte dieser Eigenschaften durch einen Aufruf von ClearValue gelöscht.

void RestoreDefaultProperties(object sender, RoutedEventArgs e)
{
    UIElementCollection uic = Sandbox.Children;
    foreach (Shape uie in uic)
    {
        LocalValueEnumerator locallySetProperties = uie.GetLocalValueEnumerator();
        while (locallySetProperties.MoveNext())
        {
            DependencyProperty propertyToClear = (DependencyProperty)locallySetProperties.Current.Property;
            if (!propertyToClear.ReadOnly) { uie.ClearValue(propertyToClear); }
        }
    }
}


Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0

Community-Beiträge

Anzeigen:
© 2014 Microsoft