Silverlight资源字典Word文档下载推荐.docx

1、应用程序资源和直接资源之间的引用 6资源字典和 XamlReader.Load 6从代码中引用资源 7重用资源 8资源字典和本地化 9 适用于 ResourceDictionary 用法的对象 键和资源 直接资源和应用程序资源 从 XAML 中引用资源 合并资源字典 ResourceDictionary 中的前向引用 资源字典和 XamlReader.Load 模板中的 StaticResource 从代码中引用资源 运行时用法 重用资源 generic.xaml 与 WPF 在 ResourceDictionary 实现上的差异 资源字典和本地化 适用于 JavaScript API 的 R

2、esourceDictionary 相关主题 适用于 ResourceDictionary 用法的对象 在 Silverlight 中，并非所有类型和对象都适合 ResourceDictionary 用法。为了在 ResourceDictionary 中定义某个对象并从其中访问该对象，该对象必须成为可共享的对象。可共享是必要的，因为当应用程序的对象树最终完成构造并在运行时使用时，对象不能存在于树中的多个位置。必须或者存在一个真正的共享机制，或者存在一个引用之类的间接机制。这两种机制都要求附加的代码支持。从 UIElement 类型派生的任何对象在本质上都不是可共享的，除非该对象是从控件模板生成

3、的（Silverlight 控件模板化子系统是间接机制的一个突出示例）。Silverlight ResourceDictionary 用法支持以下对象类别的可共享用法： 样式和模板。 画笔和颜色。 包括演示图板的动画类型。 转换。 Matrix 、Matrix3D 和 Point 结构值。 某些具有可设置和可构造属性（例如 Thickness 和 CornerRadius）的其他结构。但是，这些结构通常要求在 XAML 中使用初始化文本以便声明有用值；有关更多信息，请参见参考主题中的“XAML 用法”部分。 在支持代码中定义然后在 XAML 中实例化为资源的自定义类型，如资源的转换器。 字符串

4、和基本数值，如 double 和 int。请注意，XAML 中对这些系统类型的对象元素用法要求您映射 System 命名空间和 mscorlib 程序集（其中基元定义后备类型）。相关语法通常为 xmlns:sys=clr-namespace:System;assembly=mscorlib。有关 XAML 命名空间映射的更多信息，请参见 Silverlight XAML 命名空间以及将 XAML 命名空间映射为前缀。键和资源 ResourceDictionary 中的项必须各有一个定义的键。在 XAML 中，可通过为作为 ResourceDictionary 内容添加的对象元素的 x:Key

5、特性提供值来指派键。说明： 在资源字典概念的 Silverlight 实现中，ResourceDictionary 可以有 x:Name，而不是 x:Key?或者二者兼而有之。如果未指定 x:Key，则 x:Name 用作键。x:Name / x:Key 替换支持某些应用程序可能仍在使用的旧式资源字典用法。如果 XAML 包含的 ResourceDictionary 所包含的项具有 x:Name，但没有 x:Key，则某些工具或开发环境可能针对该 XAML 发出警告。但是，x:Key 替换对于运行时 XAML 分析将是有效的。如果要在 XAML 标记中使用键控资源，通常可以通过一个 xmlns

6、 声明映射 XAML 语言本身的 XAML 命名空间。这通常是必需的，因为 x:Name 和 x:Key 是由 XAML 语言 XAML 命名空间定义的。Silverlight 文档假定 XAML 固有的典型映射前缀为 x:因此，文档中对“Key”的引用通常采用 x:Key 格式，同时预置假定的 x 前缀。此外，通常还在根元素级别同时映射默认 Silverlight 命名空间和 XAML 语言 XAML 命名空间。SilverlightXAMLResourceDictionary中的资源必须使用字符串作为它们的键名。有关键名的字符串值限制，请参见 XamlName 语法。Silverlight

7、 中用于键名的值必须符合此语法。如果您包括的项在资源字典中不具有可用键，则会发生分析器异常。当您复制键时，就会发生分析器异常。通常，如果键、无法创建的对象元素或资源查找存在问题，则在代码编译期间将不会始终检测到这些问题，仅当 Silverlight 在运行时尝试加载 XAML 时才会将它们报告为异常。直接资源和应用程序资源 接受 ResourceDictionary 类型的值的两个属性是：FrameworkElement.Resources 和 Application.Resources。FrameworkElement.Resources 提供直接资源。在 XAML 中，可以从任何满足以下条

8、件的元素引用 FrameworkElement.Resources 中的键控资源：连接到这些资源所在的对象树。通常，为 XAML 页的根元素定义 FrameworkElement.Resources 值，并且通常而言，对于用户应用程序来说，UI 页的根元素为 UserControl。因此，常见用法是定义可由页用作 UserControl.Resources 内的元素的所有直接资源。Application.Resources 提供应用程序范围的资源。无论哪个页作为应用程序的当前 RootVisual 加载，由 Application.Resources 定义的资源都是可用的。如果将不同的可能页加

9、载到 RootVisual，并且需要一种方法来避免复制各个可能页中相同的资源，这可能很重要。此外，如果要在运行时将值写入资源字典，应用程序作用域将提供一个可以在应用程序生存期中保存这些资源的位置。请不要将与 ResourceDictionary 有关的概念同 Resources 生成操作、.resx 文件以及在关于如何组织项目（在 MSBUILD 或 Visual Studio 等开发环境中生成应用程序）结构的上下文中讨论的其他资源相混淆。尽管生成操作和应用程序结构的资源概念可以与 ResourceDictionary 用法重叠，但是 ResourceDictionary 通常可被视为提供自包

10、含的资源系统，该系统将 XAML 作为其主要定义格式合并进来。从 XAML 中引用资源 在 XAML 中，可通过使用 StaticResource 标记扩展来引用来自 ResourceDictionary 的现有资源。若要使用标记扩展，应始终引用通过属性 （Attribute） 用法设置的属性 （Property）。例如，若要将 Button 的 Background 属性的值设置为您定义的资源，可声明以下 XAML：复制 . GradientStop Color=Gray1/LinearGradientBrush/ResourceDictionary!-XAML within a UserC

11、ontrol or some other root that defines application UI-Button Background=StaticResource fadeBrush ./在此示例中，XAML 的两个部分甚至可能不位于同一 XAML 文件中。ResourceDictionary 可能在 Resources 或打包的控件主题 （generic.xaml） 中定义。即使您设置的属性通常要求 XAML 中的属性元素用法来指定其值，您也应使用属性语法来用于资源引用。例如，下面是等效的属性元素用法（如果以内联方式定义 LinearGradientBrush，而不是引用 Reso

12、urceDictionary 资源）：ButtonButton.BackgroundLinearGradientBrush/Button.Background/Button不能将 StaticResource 周围的属性元素用法显式用作对象元素内容。在 Silverlight 中，StaticResource 标记扩展仅支持用作属性值（而不支持用作对象元素）。StaticResource 的查找行为StaticResource 的查找行为是 XAML 的标记编译处理将首先检查应用实际用法的对象是否能够保存 FrameworkElement.Resources 值。如果能，将检查该 Resour

13、ceDictionary 中是否有该键所对应的项。此级别的查找并不重要，因为您通常不会在同一对象上定义并引用资源。接下来发生的情况更重要。查找过程将检查下一个对象树父级是否存在 FrameworkElement.Resources，如果存在，则检查是否存在具有指定键字符串的字典项。该过程一直继续，直到到达了 XAML 的根元素。该过程通常在页的根级别定义所有直接资源，无论是为了利用此资源查找行为还是作为一种标记样式。如果在直接资源中找不到请求的资源，则下一个查找步骤是检查 Application.Resources。在本文档中，直接资源有时候还称作页级别资源。请求 ResourceDictionary 资源的典型 XAML 文件也是这样一种 XAML 文件：其中，根是 Silverlight UserControl，它定义第一个 RootVisual 或随后的“页”以便用于导航。如果仍然找不到所请求的键，将发生 XAML 分析器异常。在某些情况下，该 XAML 分析器异常可能是 XAML 标记编译检测不到的运行时异常。有关此概念的更多信息，请参见代码隐藏和分部类。基于此查找行为，可以特意定义多个具有与键相同的字符串值的资源，只要每个这样的资源都