提供值的任何XAML通过推迟将对定义资源的引用值的属性特性。 类似于运行时查找该资源的查找行为。
XAML 属性用法
<object property="{DynamicResource key}" .../>
XAML 属性元素用法
<object>
<object.property>
<DynamicResource ResourceKey="key" .../>
</object.property>
</object>
XAML 值
key |
所请求资源的密钥。 最初由该键X:key 指令如果资源已在标记中,或作为提供key参数调用时xref:System.Windows.ResourceDictionary.Add*?displayProperty=nameWithType如果资源在代码中创建的。 |
备注
一个DynamicResource将创建初始编译期间的临时表达式并因此延迟的资源查找,直到实际需要来构造对象请求的资源值为止。 这可能后XAML加载页面。 资源值将基于与当前的页范围,从开始的所有活动的资源字典的密钥搜索找到并替换为从编译的占位符表达式。
Important: 依赖关系属性在优先级方面,
DynamicResource表达式等效于应用的动态资源引用的位置的位置。 如果将以前的属性的本地值DynamicResource作为本地值,表达式DynamicResource完全删除。 有关详细信息,请参阅依赖属性值优先级。
某些资源的访问方案是特别适合DynamicResource而不是StaticResource 标记扩展。 请参阅XAML 资源有关的相对优点和性能产生的影响的讨论DynamicResource和StaticResource。
指定xref:System.Windows.DynamicResourceExtension.ResourceKey*应该对应于现有的资源由X:key 指令在您的页面、 应用程序、 可用的控件的主题和外部资源或系统资源,在某种程度上和查找资源也将按该顺序。 有关静态和动态资源的资源查找的详细信息,请参阅XAML 资源。
资源键可以是任何字符串中定义XamlName 语法。 资源键也可以是其他对象类型,如xref:System.Type。 一个xref:System.Type密钥是如何可以由主题样式控件的基础。 有关详细信息,请参阅控件创作概述。
Api,可用于查找资源的值,例如xref:System.Windows.FrameworkElement.FindResource*,遵循所使用的相同的资源查找逻辑DynamicResource。
引用资源的可选声明性方式是作为StaticResource 标记扩展。
特性语法是最常用于该标记扩展的语法。 在 DynamicResource 标识符字符串之后提供的字符串标记被指定为基础 xref:System.Windows.DynamicResourceExtension.ResourceKey* 扩展类的 xref:System.Windows.DynamicResourceExtension 值。
DynamicResource 可以在对象元素语法中使用。 在这种情况下,指定的值xref:System.Windows.DynamicResourceExtension.ResourceKey*属性是必需的。
DynamicResource 还可以在详细特性用法中使用,以便将 xref:System.Windows.DynamicResourceExtension.ResourceKey* 属性指定为一个 property=value 对:
<object property="{DynamicResource ResourceKey=key}" .../>
如果扩展具有一个以上的可设置属性,或者某些属性是可选的,则详细用法通常会很有用。 由于 DynamicResource 仅有一个可设置的属性,并且此属性是必需的,因此该详细用法不具有典型性。
在中WPFXAML处理器实现中,对此标记扩展的处理由定义xref:System.Windows.DynamicResourceExtension类。
DynamicResource 是标记扩展。 当要求转义特性值应为非文本值或非处理程序名称时,通常会实现标记扩展,相对于只在某些类型或属性上放置类型转换器而言,此需求更具有全局性。 XAML 中的所有标记扩展在其特性语法中都使用 { 和 } 字符,XAML 处理器通过这一约定确认标记扩展必须处理该特性。 有关详细信息,请参阅标记扩展和 WPF XAML。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
