《Programming WPF》翻译 第6章 3.二进制资源

尽管ResourceDictionary和系统级别的资源适合于作为数据存在于对象中，然而，并不是所有的资源都能很好的满足这个模型。能够处理二进制流通常是很有用的。例如，图像，声频和视频，都是有效地二进制的代表，但是这些资源在xaml内都没有相应的标签，而且毕竟这些对象通常表现为底层数据的包装。标记语言本身代表了一种挑战：xaml页面必须编译到我们的应用程序中。因此，需要一种处理二进制流的方法。

WPF并未引进任何新技术处理二进制数据。.NET框架已经提供了处理内嵌二进制流的机制，WPF只是简单使用了这个技术。

最底层的流支持你内嵌资源流到任何的编译文件中。提供内嵌到编译器的文件是一种简单的方式。在Visual Studio 2005中，你可以通过设置一个文件的Build Action属性来支持内嵌资源。：复制该文件的内容，作为一个内嵌流放入编译文件中。使用Assembly的GetManifestResourceStream方法，可以在运行期获取到这个流，正如示例6－25所示：

示例6-25

Assembly asm = Assembly.GetExecutingAssembly( );
Stream s = asm.GetManifestResourceStream("StreamName");

这种方式的内嵌流称为“资源清单”。WPF最终依赖于这种资源内嵌机制，可以通过System.Resources命名空间的ResourceManager类直接使用。这是建立在内嵌资源系统上，附加两个特点：本地化和在一个底层流中按名字存储多个流的能力。ResourceManager允许我们按照名字寻找资源，这将要尝试根据UI文化定位最合适的资源，更多细节将在下一部分描述。

按照规定，一个WPF的应用程序或组件将其所有资源放入一个单独的资源清单的中，称之为Appname.g.resources，其中Appname是程序或组件的名称（不包含扩展名）。这个单独的资源流包含二进制的资源，可以通过ResourceManager获取到。示例6-26展示了如何获取一个资源名称的清单。

示例6-26

static List<string> GetResourceNames(Assembly asm,
                       System.Globalization.CultureInfo culture) {

    string resourceName = asm.GetName( ).Name + ".g";
    ResourceManager rm = new ResourceManager(resourceName, asm);
    ResourceSet resourceSet = rm.GetResourceSet(culture, true, true);
    List<string> resources = new List<string>( );
    foreach (DictionaryEntry resource in resourceSet) {

        resources.Add((string) resource.Key);
    }
    rm.ReleaseAllResources( );
    return resources;
}

让我们通过这段代码，着眼于一个典型的应用程序内部的发现资源。图6-6展示了一个WPF工程的Visual Studio 2005解决方案管理器视图。这个工程包含了通常的定义了应用程序的MyApp.xaml文件，一个定义了用户界面的Window1.xaml文件（在一个包含多个窗体和页面的应用程序中，你可以看到更多xaml文件）。这个工程还包括一个Images目录，其中有两张图片。正如你在图6-6下半部分的属性面板中看到的，Sunset.jpg的Build Action属性已经设置为Resource。当你添加一个bmp图片到解决方案中时，在解决方案管理器视图的上下文菜单，选择Add--New Item…或者Add—Existing Item…，那么这个图片的Build Action属性会自动设置为Resource。对于Wheel.jpg也是同样的设置。

图6-6

如果我们调用示例6-26中的ResourceNames函数并且打印出其返回值，可以看到下列输出：

myapp.baml
window1.baml
image/wheel.jpg
image/sunset.jpg

正如你看到的，所有的bmp文件都在上面列出了。你可以在任意元素中通过指定URL的方式使用这些内嵌的图片，正如示例6-27展示的。这里使用了相对URL路径，表明这个Image元素使用的是本地资源。相对URL不仅可以用于图片文件与应用程序在同一目录，而且可以作为一个内嵌资源。既然图片数据可以内嵌在二进制程序的资源流中，那么没有必要将其转移到一个独立的包含图片数据的文件中了。

示例6-27

<Image Source="images/wheel.jpg" />

上述资源列表还显示了myapp.baml和window1.baml两个资源，对应到相应的两个xaml文件。

BAML是xaml文件的二进制表现形式。Xaml在编译期间被编译成BAML格式有两个原因。首先，BAML比xaml更加显著的简捷，所以你的可执行文件比xaml文件要小得很多。其次，BAML在设计上更易于阅读，支持UI加载的速度更快——相对于xaml的语法解析。

在一个WPF工程中，任意具有Build Action的页面文件都是xaml形式。这将编译成BAML，并被内嵌为一个资源。

因为图片，BAML文件，以及任意的内嵌二进制资源都使用ResourceManager机制，这为应用程序的本地化提供了一个方法。