大网数据广告活动
.NET 与 C# 开发

只读依赖项属性

· 52CE 我爱测

本主题介绍只读依赖属性,包括现有只读依赖属性、创建自定义只读依赖属性的方案和技术。

本主题介绍只读依赖属性,包括现有只读依赖属性、创建自定义只读依赖属性的方案和技术。

系统必备

本主题假定你了解实现依赖属性的基本方案,以及如何将元数据应用于自定义依赖属性。 有关上下文,请参阅自定义依赖属性和依赖属性元数据。

现有只读依赖属性

在 Windows Presentation Foundation (WPF) 框架中定义的某些依赖属性是只读的。 指定只读依赖属性的一般原因如下:这些属性应该用于状态确定,但是有多种因素影响该状态,从用户界面设计的角度看,仅将属性设置为该状态并不能达到预期的效果。 例如, 属性xref:System.Windows.UIElement.IsMouseOver*实际上只是从鼠标输入中确定的状态。 任何通过避开实际的鼠标输入以编程方式设置此值的尝试都是不可预期的,并将导致不一致。

由于其不可设置性,只读依赖属性不适用于依赖属性通常为其提供一个解决方案(即:数据绑定,直接样式化为某个值、验证、动画和继承)的多种方案。 尽管不可设置,但只读依赖属性仍具有一些由属性系统中的依赖属性支持的其他功能。 只读依赖属性仍可以用作样式中的属性触发器,这是其他功能中最重要的功能。 不能使用正常的公共语言运行时 (CLR) 属性启用触发器;它需要是依赖属性。 上述xref:System.Windows.UIElement.IsMouseOver*属性是一种很好的示例, 其中对于定义控件样式可能非常有用, 其中, 一些可见属性 (如) 中复合元素的背景、前景或类似属性当用户将鼠标放在控件的某个已定义区域上时, 控件将更改。 只读依赖属性中的更改还可以由属性系统的固有失效进程检测并报告,这实际上是在内部支持属性触发器功能。

创建自定义只读依赖属性

请务必阅读上一节中有关只读依赖属性为何不适用于许多典型依赖属性方案的内容。 但是如果有适当的方案,可能需要创建自己的只读依赖属性。

创建只读依赖属性的大多数过程与自定义依赖属性和实现依赖属性主题中介绍的过程相同。 但有三个重要的差异:

无论你具有什么专用字段或值,可使用你确定的任何逻辑来完全编写对只读依赖属性的支持。 不过, 最初或作为运行时逻辑的一部分设置属性的最直接方法是使用属性系统的 Api, 而不是绕过属性系统并直接设置私有支持字段。 特别是, 有一个接受类型xref:System.Windows.DependencyObject.SetValue* xref:System.Windows.DependencyPropertyKey为的参数的签名。 在应用程序逻辑中以编程方式设置此值的方式和位置将影响你在首次注册依赖xref:System.Windows.DependencyPropertyKey属性时, 如何对创建的设置进行访问。 如果完全在专有类中处理此逻辑,或者如果要求从程序集的其他部分对其进行设置,可以在内部进行设置。 一种方法是在xref:System.Windows.DependencyObject.SetValue*相关事件的类事件处理程序中调用, 该事件通知类实例存储的属性值需要更改。 另一种方法是在注册期间使用成对xref:System.Windows.PropertyChangedCallback的和xref:System.Windows.CoerceValueCallback回调作为这些属性的元数据的一部分来关联依赖属性。

xref:System.Windows.DependencyPropertyKey由于是私有的, 而不是由代码之外的属性系统传播的, 因此, 只读依赖项属性确实比读写依赖属性具有更好的设置安全性。 对于读写依赖属性,标识字段是显式或隐式公用的,因此该属性可广泛设置。 有关更多详细信息,请参阅依赖属性的安全性。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。