DependencyObject.ClearValue Метод

Определение

Пространство имен:

System.Windows

Сборка:

WindowsBase.dll

Очищает локальное значение свойства.

Перегрузки

ClearValue(DependencyProperty)	Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty.
ClearValue(DependencyPropertyKey)	Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey.

ClearValue(DependencyProperty)

Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty.

C#

public void ClearValue(System.Windows.DependencyProperty dp);

Параметры

dp

DependencyProperty

Очищаемое свойство зависимостей, идентифицируемое ссылкой на объект DependencyProperty.

Исключения

InvalidOperationException

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

Примеры

В следующем примере выполняется итерация всех свойств с локальными значениями, заданными для объекта , а затем вызывается ClearValue для очистки значений каждого такого свойства.

C#

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); }
        }
    }
}

Комментарии

Очистка значения свойства путем вызова ClearValue не обязательно дает свойству зависимостей значение по умолчанию, указанное в метаданных свойства зависимостей. Очистка свойства очищает только то локальное значение, которое могло быть применено. Дополнительные сведения см. в разделе Приоритет значений свойств зависимостей.

См. также раздел

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey.

C#

public void ClearValue(System.Windows.DependencyPropertyKey key);

Параметры

key

DependencyPropertyKey

Ключ очищаемого свойства зависимостей.

Исключения

InvalidOperationException

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

Комментарии

Идентифицирует DependencyPropertyKey доступное только для чтения свойство зависимостей для системных операций свойств. Классы, определяющие свойства зависимостей только для чтения, не должны предоставлять этот ключ с открытым доступом. Открытый ключ предоставляет путь к открытому коду, который отрицает символ свойства только для чтения, если такие методы, как ClearValue или SetValue , могут вызываться вне класса или сборки, ссылаясь на ключ.

Очистка значения свойства путем вызова ClearValue не обязательно дает свойству зависимостей значение по умолчанию, указанное в метаданных свойства зависимостей. При очистке значения очищается только локальное значение, которое могло быть применено. Дополнительные сведения см. в разделе Приоритет значений свойств зависимостей.

См. также раздел

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey