要查看英语原文,请勾选“英语”复选框。也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语
本文档已存档,并且将不进行维护。

DependencyObject.ClearValue 方法 (DependencyProperty)

清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。

命名空间:  System.Windows
程序集:  WindowsBase(在 WindowsBase.dll 中)

public void ClearValue(
	DependencyProperty dp
)

参数

dp
类型:System.Windows.DependencyProperty
要清除的依赖项属性,由DependencyProperty对象引用标识。

异常条件
InvalidOperationException

尝试对密封的 DependencyObject 调用 ClearValue

通过调用 ClearValue 清除属性值不一定会赋予依赖项属性默认值,该默认值是在依赖项属性元数据中指定的。 清除属性只会特别清除任何已应用的本地值。 有关更多信息,请参见 依赖项属性值优先级

下面的示例将迭代在对象上设置了本地值的所有属性,然后调用 ClearValue 来清除其中每个属性的值。


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


.NET Framework

受以下版本支持:4、3.5、3.0

.NET Framework Client Profile

受以下版本支持:4、3.5 SP1

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求
显示: