提供值的任何XAML通过查找对已定义资源的引用的属性特性。 对该资源的查找行为是类似于加载时查找,将在当前的标记从先前加载的资源查找XAML以及其他应用程序源页上,将生成与该资源值在运行时对象的属性值。
XAML 属性用法
<object property="{StaticResource key}" .../>
XAML 对象元素用法
<object>
<object.property>
<StaticResource ResourceKey="key" .../>
</object.property>
</object>
XAML 值
key |
所请求资源的密钥。 最初由该键X:key 指令如果资源已在标记中,或作为提供key参数调用时xref:System.Windows.ResourceDictionary.Add*?displayProperty=nameWithType如果资源在代码中创建的。 |
备注
Important: 一个
StaticResource不能尝试使对资源定义前向引用在词法上进一步XAML文件。 不支持尝试这样做,并且即使此类引用不会失败,尝试前向引用将会产生对加载时间性能产生负面影响时表示的内部哈希表xref:System.Windows.ResourceDictionary搜索。 为获得最佳结果,调整资源字典的组合,这样可以避免前向引用。 如果无法避免前向引用,使用DynamicResource 标记扩展相反。
指定xref:System.Windows.StaticResourceExtension.ResourceKey*应该对应于现有资源,以标识X:key 指令页面、 应用程序,可用的控件的主题和外部资源或系统资源中的某个级别。 资源查找发生的顺序。 有关静态和动态资源的资源查找行为的详细信息,请参阅XAML 资源。
资源键可以是任何字符串中定义XamlName 语法。 资源键也可以是其他对象类型,如xref:System.Type。 一个xref:System.Type密钥是如何控件可以设置的样式的主题,通过隐式样式项的基础。 有关详细信息,请参阅控件创作概述。
引用资源的可选声明性方式是作为DynamicResource 标记扩展。
特性语法是最常用于该标记扩展的语法。 在 StaticResource 标识符字符串之后提供的字符串标记被指定为基础 xref:System.Windows.StaticResourceExtension.ResourceKey* 扩展类的 xref:System.Windows.StaticResourceExtension 值。
StaticResource 可以在对象元素语法中使用。 在这种情况下,指定的值xref:System.Windows.StaticResourceExtension.ResourceKey*属性是必需的。
StaticResource 还可以在详细特性用法中使用,以便将 xref:System.Windows.StaticResourceExtension.ResourceKey* 属性指定为一个 property=value 对:
<object property="{StaticResource ResourceKey=key}" .../>
如果扩展具有一个以上的可设置属性,或者某些属性是可选的,则详细用法通常会很有用。 由于 StaticResource 仅有一个可设置的属性,并且此属性是必需的,因此该详细用法不具有典型性。
在中WPFXAML处理器实现中,对此标记扩展的处理由定义xref:System.Windows.StaticResourceExtension类。
StaticResource 是标记扩展。 当要求转义特性值应为非文本值或非处理程序名称时,通常会实现标记扩展,相对于只在某些类型或属性上放置类型转换器而言,此需求更具有全局性。 XAML 中的所有标记扩展在其特性语法中都使用 { 和 } 字符,XAML 处理器通过这一约定确认标记扩展必须处理该特性。 有关详细信息,请参阅标记扩展和 WPF XAML。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
