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

时间:2023-03-09 05:58:00
《Programming WPF》翻译 第6章 3.二进制资源

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

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

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

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

示例6-25

《Programming WPF》翻译 第6章 3.二进制资源Assembly asm = Assembly.GetExecutingAssembly( );

《Programming WPF》翻译 第6章 3.二进制资源Stream s = asm.GetManifestResourceStream("StreamName");

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

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

示例6-26

《Programming WPF》翻译 第6章 3.二进制资源static List<string> GetResourceNames(Assembly asm,

《Programming WPF》翻译 第6章 3.二进制资源《Programming WPF》翻译 第6章 3.二进制资源                       System.Globalization.CultureInfo culture) 《Programming WPF》翻译 第6章 3.二进制资源{

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

《Programming WPF》翻译 第6章 3.二进制资源    string resourceName = asm.GetName( ).Name + ".g";

《Programming WPF》翻译 第6章 3.二进制资源    ResourceManager rm = new ResourceManager(resourceName, asm);

《Programming WPF》翻译 第6章 3.二进制资源    ResourceSet resourceSet = rm.GetResourceSet(culture, true, true);

《Programming WPF》翻译 第6章 3.二进制资源    List<string> resources = new List<string>( );

《Programming WPF》翻译 第6章 3.二进制资源《Programming WPF》翻译 第6章 3.二进制资源    foreach (DictionaryEntry resource in resourceSet) 《Programming WPF》翻译 第6章 3.二进制资源{

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

《Programming WPF》翻译 第6章 3.二进制资源        resources.Add((string) resource.Key);

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

《Programming WPF》翻译 第6章 3.二进制资源    rm.ReleaseAllResources( );

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

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

让我们通过这段代码,着眼于一个典型的应用程序内部的发现资源。图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

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

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

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

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

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

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

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

示例6-27

《Programming WPF》翻译 第6章 3.二进制资源<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机制,这为应用程序的本地化提供了一个方法。