定义和引用从外部程序集加载的资源的键。 这使得资源查找可以在程序集中指定目标类型, 而不是在程序集或类中指定显式资源字典。
XAML 特性用法 (设置键, compact)
<object x:Key="{ComponentResourceKey {x:Type targetTypeName}, targetID}" .../>
XAML 特性用法 (设置键, 详细)
<object x:Key="{ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}" .../>
XAML 特性用法 (请求资源, compact)
<object property="{DynamicResource {ComponentResourceKey {x:Type targetTypeName}, targetID}}" .../>
XAML 特性用法 (请求资源, 详细)
<object property="{DynamicResource {ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}}" .../>
XAML 值
targetTypeName |
在资源程序集中定义的公共公共语言运行时 (CLR) 类型的名称。 |
targetID |
资源的键。 查找资源时, targetID将类似于资源的 "x:Key"指令。 |
备注
如以上用法中所示, 可在ComponentResourceKey以下两个位置找到 {} 标记扩展用法:
-
主题资源字典中的键的定义, 由控件作者提供。
-
在重新模板化控件时访问程序集中的主题资源, 但需要使用由控件主题提供的资源提供的属性值。
对于引用来自主题的组件资源, 通常建议使用{DynamicResource} {StaticResource}而不是。 用法中显示了这种情况。 {DynamicResource}建议使用, 因为用户可以更改主题本身。 如果希望组件资源与控件作者为支持主题最匹配, 则应使组件资源引用也是动态的。
xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly*标识在实际定义资源的目标程序集中存在的类型。 可以定义和使用独立于确切了解定义的位置, xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly*但最终必须通过引用的程序集解析类型。 ComponentResourceKey
的一个常见用途xref:System.Windows.ComponentResourceKey是定义随后作为类的成员公开的键。 对于此用法, 使用xref:System.Windows.ComponentResourceKey类构造函数, 而不是标记扩展。 有关详细信息, 请xref:System.Windows.ComponentResourceKey参阅或主题控件创作概述的 "定义和引用主题资源的键" 一节。
对于建立密钥和引用键控资源, 特性语法通常用于ComponentResourceKey标记扩展。
所示的压缩语法依赖于xref:System.Windows.ComponentResourceKey.%23ctor*?displayProperty=nameWithType标记扩展的构造函数签名和位置参数用法。 给定targetTypeName 和targetID的顺序非常重要。 详细语法依赖于无参数xref:System.Windows.ComponentResourceKey.%23ctor*?displayProperty=nameWithType的构造函数, 然后以与xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly* object xref:System.Windows.ComponentResourceKey.ResourceId*元素上的 true 特性语法类似的方式来设置和。 在详细语法中, 设置属性的顺序并不重要。 主题标记扩展和 WPF XAML中更详细地介绍了这两种备选方法 (简洁和详细) 的关系和机制。
从技术上来说, targetID的值可以是任何对象, 不一定是字符串。 不过, WPF 最常见的用法是将targetID值与字符串形式的窗体进行对齐, 在XamlName 语法中, 此类字符串有效。
ComponentResourceKey可以在对象元素语法中使用。 在这种情况下, 需要指定xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly*和xref:System.Windows.ComponentResourceKey.ResourceId*属性的值才能正确地初始化扩展。
在读取器实现中, 对此标记xref:System.Windows.ComponentResourceKey扩展的处理由类定义。 XAML WPF
ComponentResourceKey 是标记扩展。 当要求转义特性值应为非文本值或非处理程序名称时,通常会实现标记扩展,相对于只在某些类型或属性上放置类型转换器而言,此需求更具有全局性。 XAML 中的所有标记扩展在其特性语法中都使用 { 和 } 字符,XAML 处理器通过这一约定确认标记扩展必须处理该特性。 有关详细信息,请参阅标记扩展和 WPF XAML。
请参阅
- xref:System.Windows.ComponentResourceKey
- xref:System.Windows.Controls.ControlTemplate
- 控件创作概述
- XAML 概述 (WPF)
- 标记扩展和 WPF XAML
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
