DependencyObject.ClearValue Metoda

Definice

Vymaže místní hodnotu vlastnosti.Clears the local value of a property.

Přetížení

ClearValue(DependencyProperty)

Vymaže místní hodnotu vlastnosti.Clears the local value of a property. Vlastnost, která má být vyčištěna, je určena DependencyProperty identifikátorem.The property to be cleared is specified by a DependencyProperty identifier.

ClearValue(DependencyPropertyKey)

Vymaže místní hodnotu vlastnosti jen pro čtení.Clears the local value of a read-only property. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

ClearValue(DependencyProperty)

Vymaže místní hodnotu vlastnosti.Clears the local value of a property. Vlastnost, která má být vyčištěna, je určena DependencyProperty identifikátorem.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)

Parametry

dp
DependencyProperty

Vlastnost závislosti, která má být vymazána, identifikovaná DependencyProperty odkazem na objekt.The dependency property to be cleared, identified by a DependencyProperty object reference.

Výjimky

Došlo k pokusu o volání ClearValue(DependencyProperty) na zapečetěné DependencyObject .Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Příklady

Následující příklad provede iteraci všech vlastností, které mají místní hodnoty nastavené u objektu, a pak volání ClearValue pro vymazání hodnot každé takové vlastnosti.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

Poznámky

Vymazání hodnoty vlastnosti voláním ClearValue nemusí nutně poskytnout vlastnost závislosti výchozí hodnotě, která je zadána v metadatech vlastností závislosti.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. Vymazání vlastnosti pouze konkrétně zruší, že byla použita místní hodnota.Clearing the property only specifically clears whatever local value may have been applied. Další informace najdete v tématu Priorita hodnoty vlastností závislosti.For more information, see Dependency Property Value Precedence.

Viz také

ClearValue(DependencyPropertyKey)

Vymaže místní hodnotu vlastnosti jen pro čtení.Clears the local value of a read-only property. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey .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)

Parametry

key
DependencyPropertyKey

Klíč pro vlastnost závislosti, která se má vymazatThe key for the dependency property to be cleared.

Výjimky

Došlo k pokusu o volání ClearValue(DependencyProperty) na zapečetěné DependencyObject .Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Poznámky

DependencyPropertyKeyUrčuje vlastnost závislosti jen pro čtení pro operace systému vlastností.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Třídy, které definují vlastnosti závislosti jen pro čtení, by neměly vystavovat tento klíč s veřejným přístupem.Classes that define read-only dependency properties should not expose this key with public access. Veřejně vystavený klíč by poskytoval cestu veřejného kódu, který se odvolal znak vlastnosti jen pro čtení, pokud metody jako ClearValue nebo SetValue by mohly být volány vně třídy nebo sestavení s odkazem na klíč.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.

Vymazání hodnoty vlastnosti voláním ClearValue nemusí nutně poskytnout vlastnost závislosti výchozí hodnotě, která je zadána v metadatech vlastností závislosti.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. Vymazání hodnoty se konkrétně vymaže jenom v případě, že je možné použít místní hodnotu.Clearing the value only specifically clears whatever local value may have been applied. Další informace najdete v tématu Priorita hodnoty vlastností závislosti.For more information, see Dependency Property Value Precedence.

Viz také

Platí pro