DependencyObject.ClearValue Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Vymaže místní hodnotu vlastnosti.

Přetížení

Name	Description
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty .
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey.

ClearValue(DependencyProperty)

Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty .

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)

Parametry

dp

DependencyProperty

Vlastnost závislosti, která se má vymazat, identifikovaná odkazem DependencyProperty na objekt.

Výjimky

InvalidOperationException

Pokusil se zavolat ClearValue(DependencyProperty) na zapečetěný DependencyObject.

Příklady

Následující příklad iteruje všechny vlastnosti, které mají místní hodnoty nastavené na objektu, a potom volání ClearValue vymazat hodnoty každé takové vlastnosti.

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

Poznámky

Vymazání hodnoty vlastnosti voláním ClearValue nemusí nutně poskytnout vlastnost závislosti výchozí hodnotu, která je určena v metadatech vlastnosti závislosti. Vymazání vlastnosti pouze vymaže jakoukoli místní hodnotu, kterou bylo možné použít. Další informace naleznete v tématu Priorita hodnoty vlastnosti závislosti.

Viz také

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem 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)

Parametry

key

DependencyPropertyKey

Klíč vlastnosti závislosti, která se má vymazat.

Výjimky

InvalidOperationException

Pokusil se zavolat ClearValue(DependencyProperty) na zapečetěný DependencyObject.

Poznámky

A DependencyPropertyKey identifikuje vlastnost závislosti jen pro čtení pro operace systému vlastností. Třídy, které definují vlastnosti závislosti jen pro čtení, by neměly vystavit tento klíč s veřejným přístupem. Veřejně zpřístupněný klíč by poskytoval cestu veřejného kódu, která negovala znak vlastnosti jen pro čtení, pokud metody, jako ClearValue jsou nebo mohou být volány mimo třídu nebo SetValue sestavení, odkazující na klíč.

Vymazání hodnoty vlastnosti voláním ClearValue nemusí nutně poskytnout vlastnost závislosti výchozí hodnotu, která je určena v metadatech vlastnosti závislosti. Vymazáním hodnoty se vymaže pouze jakákoli místní hodnota, která se použila. Další informace naleznete v tématu Priorita hodnoty vlastnosti závislosti.

Viz také

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey