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

ComponentResourceKey 标记扩展

· 52CE 我爱测

定义和引用从外部程序集加载的资源的键。 这使得资源查找可以在程序集中指定目标类型, 而不是在程序集或类中指定显式资源字典。

定义和引用从外部程序集加载的资源的键。 这使得资源查找可以在程序集中指定目标类型, 而不是在程序集或类中指定显式资源字典。

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。

请参阅

历史资料。此文对应 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(示例代码)

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

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