DependencyObject.ClearValue Metoda

Definicja

Czyści wartość lokalną właściwości.Clears the local value of a property.

Przeciążenia

ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez identyfikator DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez identyfikator DependencyProperty.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

Właściwość zależności, która ma zostać wyczyszczona, identyfikowana przez DependencyProperty odwołanie do obiektu.The dependency property to be cleared, identified by a DependencyProperty object reference.

Wyjątki

Podjęto próbę wywołania ClearValue(DependencyProperty) na zapieczętowanym DependencyObject.Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Przykłady

Poniższy przykład wykonuje iterację wszystkich właściwości, które mają wartości lokalne ustawione dla obiektu, a następnie wywołuje ClearValue, aby wyczyścić wartości każdej takiej właściwości.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

Uwagi

Wyczyszczenie wartości właściwości przez wywołanie ClearValue nie musi dawać właściwości zależności wartością domyślną określoną w metadanych właściwości zależności.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. Czyszczenie właściwości tylko wyraźnie czyści, niezależnie od tego, która wartość lokalna mogła zostać zastosowana.Clearing the property only specifically clears whatever local value may have been applied. Aby uzyskać więcej informacji, zobacz pierwszeństwo wartości właściwości zależności.For more information, see Dependency Property Value Precedence.

Zobacz też

ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez 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

Klucz dla właściwości zależności, która ma zostać wyczyszczona.The key for the dependency property to be cleared.

Wyjątki

Podjęto próbę wywołania ClearValue(DependencyProperty) na zapieczętowanym DependencyObject.Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Uwagi

@No__t_0 identyfikuje właściwość zależności tylko do odczytu dla operacji systemu właściwości.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Klasy definiujące właściwości zależności tylko do odczytu nie powinny ujawniać tego klucza z dostępem publicznym.Classes that define read-only dependency properties should not expose this key with public access. Publicznie uwidoczniony klucz zapewnia publiczne ścieżki kodu, które negacją znaku tylko do odczytu właściwości, jeśli metody takie jak ClearValue lub SetValue można wywołać poza klasą lub zestawem, odwołując się do klucza.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.

Wyczyszczenie wartości właściwości przez wywołanie ClearValue nie musi dawać właściwości zależności wartością domyślną określoną w metadanych właściwości zależności.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. Czyszczenie wartości tylko wyraźnie czyści, niezależnie od tego, która wartość lokalna mogła zostać zastosowana.Clearing the value only specifically clears whatever local value may have been applied. Aby uzyskać więcej informacji, zobacz pierwszeństwo wartości właściwości zależności.For more information, see Dependency Property Value Precedence.

Zobacz też

Dotyczy