DependencyObject.ClearValue Метод

Определение

Очищает локальное значение свойства.Clears the local value of a property.

Перегрузки

ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором 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)

Параметры

dp
DependencyProperty

Очищаемое свойство зависимости, указанное объектной ссылкой DependencyProperty.The dependency property to be cleared, identified by a DependencyProperty object reference.

Исключения

Предпринята попытка вызова ClearValue(DependencyProperty) в запечатанном объекте DependencyObject.Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Примеры

В следующем примере выполняется перебор всех свойств, для которых заданы локальные значения объекта, затем вызывается ClearValue, чтобы очистить значения каждого из этих свойств.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

Комментарии

Очистка значения свойства путем вызова ClearValue не обязательно дает свойству зависимостей значение по умолчанию, указанное в метаданных свойства зависимостей.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. Очистка свойства только позволяет очистить любое локальное значение, которое могло быть применено.Clearing the property only specifically clears whatever local value may have been applied. Дополнительные сведения см. в разделе Приоритет значений свойств зависимостей.For more information, see Dependency Property Value Precedence.

Дополнительно

ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается ключом 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)

Параметры

key
DependencyPropertyKey

Ключ для очищаемого свойства зависимостей.The key for the dependency property to be cleared.

Исключения

Пытается вызвать метод ClearValue(DependencyProperty) для запечатанного DependencyObject.Attempted to call ClearValue(DependencyProperty) on a sealed DependencyObject.

Комментарии

@No__t-0 определяет свойство зависимостей "только для чтения" для операций системы свойств.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Классы, определяющие свойства зависимостей только для чтения, не должны предоставлять этот ключ с доступом Public.Classes that define read-only dependency properties should not expose this key with public access. Общедоступный ключ будет предоставлять открытый путь к коду, который обращается к символу только для чтения свойства, если такие методы, как ClearValue или SetValue, могут быть вызваны вне класса или сборки, ссылаясь на ключ.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.

Очистка значения свойства путем вызова ClearValue не обязательно дает свойству зависимостей значение по умолчанию, указанное в метаданных свойства зависимостей.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. Очистка значения только позволяет очистить любое локальное значение, которое могло быть применено.Clearing the value only specifically clears whatever local value may have been applied. Дополнительные сведения см. в разделе Приоритет значений свойств зависимостей.For more information, see Dependency Property Value Precedence.

Дополнительно

Применяется к