Windows Presentation Foundation (WPF)属性系统包含一个元数据报告系统, 该系统超出了可通过反射或一般公共语言运行时 (CLR) 特征报告的属性的内容。 依赖属性的元数据还可以由定义依赖属性的类来唯一地分配,可以在依赖属性添加到另一个类时进行更改,可以由所有从定义基类继承依赖属性的派生类来明确地重写。
系统必备
本主题假定你从 Windows Presentation Foundation (WPF) 类的现有依赖属性的使用者角度了解依赖属性,并且已阅读依赖属性概述。 若要理解本主题中的示例,还应当了解 XAML 并知道如何编写 WPF 应用程序。
依赖属性元数据的使用方式
依赖属性的元数据作为一个对象存在,可以通过查询该对象来检查依赖属性的特征。 当属性系统处理任何给定的依赖属性时,也会经常访问这些元数据。 依赖属性的元数据对象可以包含以下类型的信息:
-
依赖属性的默认值(如果通过本地值、样式和继承等信息不能确定依赖属性的其他任何值)。有关在为依赖属性赋值时,默认值如何参与属性系统所使用的优先级的完整讨论,请参阅依赖属性值优先级。
-
对影响每个所有者类型的强制行为或更改通知行为的回叫实现的引用。 请注意,这些回叫通常是用非公共访问级别定义的,因此,除非实际引用位于允许的访问范围内,否则通常无法从元数据获得这些引用。 有关依赖属性回叫的详细信息,请参阅依赖属性回调和验证。
-
如果所讨论的依赖属性被视为一个 WPF 框架级别的属性,则元数据中可能包含 WPF 框架级别的依赖属性特征,这些特征报告各种服务(如 WPF 框架级别的布局引擎和属性继承逻辑)的信息和状态。 有关依赖属性元数据的这一方面的详细信息,请参阅框架属性元数据。
元数据 API
报告属性系统使用的大多数元数据信息的类型是xref:System.Windows.PropertyMetadata类。 在向属性系统注册依赖属性时,可以选择指定元数据实例,并且可以为以下附加类型再次指定这些实例:将自身作为所有者添加的类型,或者重写它们从基类依赖属性定义继承的元数据的类型。 (在属性注册未指定元数据的情况下, 将使用xref:System.Windows.PropertyMetadata该类的默认值创建默认值。)xref:System.Windows.PropertyMetadata当调用从xref:System.Windows.DependencyObject实例的依赖项属性获取元数据xref:System.Windows.DependencyProperty.GetMetadata*的各种重载时, 将返回已注册的元数据。
然后从派生类, 以便为体系结构分部 (如 WPF 框架级类) 提供更具体的元数据。 xref:System.Windows.PropertyMetadata xref:System.Windows.UIPropertyMetadata添加动画报告, 并xref:System.Windows.FrameworkPropertyMetadata提供上一节中提到的 WPF 框架级属性。 当注册依赖属性时, 可以将它们注册到这些xref:System.Windows.PropertyMetadata派生类。 检查元数据时, 可以将基xref:System.Windows.PropertyMetadata类型强制转换为派生类, 以便可以检查更具体的属性。
Note: 在xref:System.Windows.FrameworkPropertyMetadata此文档中, 可以指定的属性特征有时被称为 "标志"。 当你创建新的元数据实例以便在依赖属性注册或元数据重写中使用时, 你可以xref:System.Windows.FrameworkPropertyMetadataOptions使用 flagwise 枚举指定这些值, 然后提供可能连接的枚举值到xref:System.Windows.FrameworkPropertyMetadata构造函数。 但是, 一旦构造后, 这些选项特征在中xref:System.Windows.FrameworkPropertyMetadata作为一系列布尔属性公开, 而不是构造枚举值。 使用布尔属性,可以检查每个条件,而不必为了获得感兴趣的信息而向按标志枚举值应用掩码。 构造函数使用串联xref:System.Windows.FrameworkPropertyMetadataOptions以便保持构造函数签名的长度合理, 而实际构造的元数据公开了离散属性, 使查询元数据更加直观。
何时重写元数据以及何时派生类
WPF 属性系统已经建立了如下功能:在不必完全重新实现依赖属性的情况下,更改依赖属性的某些特征。 这是通过为特定类型上所存在的依赖属性构造不同的属性元数据实例来完成的。 请注意,现有的大多数依赖属性都不是虚拟属性,因此,严格地说,只能通过隐藏现有成员来针对继承类“重新实现”依赖属性。
如果尝试对某个类型的依赖属性启用的方案不能通过修改现有依赖属性的特征来完成,则可能有必要创建一个派生类,然后为该派生类声明一个自定义依赖属性。 自定义依赖项属性的行为与WPF api 定义的依赖项属性的行为相同。 有关自定义依赖属性的更多详细信息,请参阅自定义依赖属性。
不能重写的依赖属性的一个显著特征就是它的值类型。 如果要继承的依赖属性的行为与所需的行为大体相同,但是要求它具有另一种类型,则必须实现一个自定义依赖属性,可能还需要通过类型转换或其他实现机制在自定义类上链接这些属性。 此外, 不能替换现有xref:System.Windows.ValidateValueCallback的, 因为此回调存在于注册字段本身中, 而不在其元数据中。
更改现有元数据的方案
如果要处理现有依赖属性的元数据,则更改依赖属性元数据的一种常见方案是更改默认值。 更改或添加属性系统回叫是一种更高级的方案。 如果所实现的派生类的依赖属性之间具有不同的相互关系,则你可能希望这样做。 让编程模型既支持代码又支持声明性用法的条件之一就是,属性必须能够按任何顺序设置。 因此,需要在没有上下文的情况下实时设置任何依赖属性,而且可以不必知道设置顺序(例如,可能在构造函数中找到的顺序)。 有关属性系统这一方面的详细信息,请参阅依赖属性回调和验证。 请注意,验证回叫不是元数据的一部分,而是依赖属性标识符的一部分。 因此,不能通过重写元数据来更改验证回叫。
在某些情况下,可能还希望在现有的依赖属性上改变 WPF 框架级别的属性元数据选项。 这些选项将有关 WPF 框架级别属性的某些已知条件传递到其他 WPF 框架级别的进程,例如布局系统。 通常, 仅当注册新的依赖属性时才会设置选项, 但也可以将 WPF 框架级别的属性元数据作为xref:System.Windows.DependencyProperty.OverrideMetadata*或xref:System.Windows.DependencyProperty.AddOwner*调用的一部分进行更改。 有关要使用的特定值以及详细信息,请参阅框架属性元数据。 有关应当如何为新注册的依赖属性设置这些选项的详细信息,请参阅自定义依赖属性。
重写元数据
重写元数据的主要目的在于,使你有机会更改各种派生自元数据的行为,这些行为应用于类型上存在的依赖属性。 元数据一节中更详细地介绍了重写元数据的原因。 有关详细信息(包括一些代码示例),请参阅重写依赖属性的元数据。
可以在注册调用 (xref:System.Windows.DependencyProperty.Register*) 期间为依赖属性提供属性元数据。 但是,在许多情况下,当类继承该依赖属性时,你可能希望为该类提供特定于类型的元数据。 可以通过调用xref:System.Windows.DependencyProperty.OverrideMetadata*方法来执行此操作。 对于来自WPF api 的示例xref:System.Windows.FrameworkElement , 类是第一次注册xref:System.Windows.UIElement.Focusable*依赖属性的类型。 但是, xref:System.Windows.Controls.Control类会重写依赖属性的元数据, 以提供其自己的初始默认值false , true将其从更改为, 否则会xref:System.Windows.UIElement.Focusable*重新使用原始实现。
当你重写元数据时,系统会合并或替换不同的元数据特征。
-
xref:System.Windows.PropertyMetadata.PropertyChangedCallback*合并。 如果添加新xref:System.Windows.PropertyMetadata.PropertyChangedCallback*的, 则该回调将存储在元数据中。 如果未xref:System.Windows.PropertyMetadata.PropertyChangedCallback*在重写中指定, 则的xref:System.Windows.PropertyMetadata.PropertyChangedCallback*值将从在元数据中指定的最接近的上级中升级为引用。
-
的实际属性系统行为xref:System.Windows.PropertyMetadata.PropertyChangedCallback*是: 在层次结构中的所有元数据所有者的实现将被保留并添加到表中, 属性系统执行顺序是首先调用派生程度最高的派生类的回调。
-
xref:System.Windows.PropertyMetadata.DefaultValue*被替换。 如果未xref:System.Windows.PropertyMetadata.DefaultValue*在重写中指定, 则的xref:System.Windows.PropertyMetadata.DefaultValue*值来自在元数据中指定它的最近上级。
-
xref:System.Windows.PropertyMetadata.CoerceValueCallback*替换实现。 如果添加新xref:System.Windows.PropertyMetadata.CoerceValueCallback*的, 则该回调将存储在元数据中。 如果未xref:System.Windows.PropertyMetadata.CoerceValueCallback*在重写中指定, 则的xref:System.Windows.PropertyMetadata.CoerceValueCallback*值将从在元数据中指定的最接近的上级中升级为引用。
-
属性系统行为是只调用直接元xref:System.Windows.PropertyMetadata.CoerceValueCallback*数据中的。 不会保留对xref:System.Windows.PropertyMetadata.CoerceValueCallback*层次结构中的其他实现的引用。
此行为由xref:System.Windows.PropertyMetadata.Merge*实现, 并且可在派生的元数据类上重写。
重写附加属性元数据
在 WPF 中,附加属性作为依赖属性来实现。 这意味着它们还具有能够由个别类重写的属性元数据。 中WPF附加属性的作用域注意事项通常xref:System.Windows.DependencyObject是在其上设置附加属性。 因此, 任何xref:System.Windows.DependencyObject派生类都可以重写任何附加属性的元数据, 因为它可能是在类的实例上设置的。 可以重写默认值、回叫或 WPF 框架级别的特征报告属性。 如果针对类的实例设置了附加属性,则这些重写属性元数据特征将适用。 例如,可以重写默认值,这样,只要未以其他方式设置附加属性,重写值就会报告为类实例的附加属性的值。
Note: xref:System.Windows.FrameworkPropertyMetadata.Inherits*属性与附加属性无关。
将类作为现有依赖属性的所有者来添加
类可以使用xref:System.Windows.DependencyProperty.AddOwner*方法将自身添加为已注册的依赖属性的所有者。 这使得该类可以使用最初针对另一个类型注册的依赖属性。 添加类通常不是首先将该依赖属性注册为所有者的类型的派生类。 实际上,这使类及其派生类可以“继承”依赖属性实现,而不需要最初的所有者类,而且添加类也不必位于同一个实际的类层次结构中。 另外,添加类(以及所有派生类)随后可以为最初的依赖属性提供特定于类型的元数据。
添加类除了通过属性系统的实用工具方法将自身添加为所有者以外,还应当在自身声明其他公共成员,以使依赖属性向代码和标记公开,从而完全参与属性系统。 就为依赖属性公开对象模型而言,添加现有依赖属性的类与定义新的自定义依赖属性的类具有相同的职责。 要公开的第一个此类成员是依赖属性标识符字段。 此字段应为public static readonly类型xref:System.Windows.DependencyProperty为的字段, 该字段将分配给xref:System.Windows.DependencyProperty.AddOwner*调用的返回值。 要定义的第二个成员是公共语言运行时 (CLR) "包装器" 属性。 包装使你可以更方便地在代码中操作依赖属性 (避免xref:System.Windows.DependencyObject.SetValue*每次调用, 并且只能在包装器中调用一次)。 包装器的实现方式与在注册自定义依赖属性时的实现方式完全相同。 有关实现依赖属性的详细信息,请参阅自定义依赖属性和为依赖属性添加所有者类型。
AddOwner 和附加属性
可以调用xref:System.Windows.DependencyProperty.AddOwner*由所有者类定义为附加属性的依赖属性。 这样做的目的通常是为了将以前附加的属性作为非附加依赖属性来公开。 然后, 你会将xref:System.Windows.DependencyProperty.AddOwner*返回值public static readonly公开为用作依赖项属性标识符的字段, 并将定义适当的 "包装器" 属性, 以便属性显示在成员表中并支持非附加属性类中的用法。
请参阅
- xref:System.Windows.PropertyMetadata
- xref:System.Windows.DependencyObject
- xref:System.Windows.DependencyProperty
- xref:System.Windows.DependencyProperty.GetMetadata*
- 依赖项属性概述
- 框架属性元数据
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
