dotnet中使用嵌入资源

最近打算做一个将 excel 文件转为 xml 的 pipeline component ，过程中需要给这个组件做个 ICON ，就需要处理位图和把 icon 作为资源嵌入到程序集中，使用时在程序集中找到 icon 的资源还原成 icon 。嵌入资源部分以前一直没做过，这回借机把嵌入资源部分的内容学习一下。

Dotnet 中嵌入资源（位图、图标或光标等）有两种方式，一是直接把资源文件加入到项目，作为嵌入资源，在代码中通过 Assembly 的 GetManifestResourceStream 方法获取资源的 Stream 。另一种方法是在项目中加入 . resx 资源文件，在资源文件中添加资源，由 ResourceManager 类统一管理其中的资源。

下面分别详述这两种方法

一、 使用GetManifestResourceStream读取嵌入资源

1、加入资源文件

直接把要嵌入到程序集的资源文件加入到项目中，可以加在项目的根目录，可以加在项目的任何目录中。

2、设置资源文件的“BuildAction”属性

将嵌入资源文件的“BuildAction”属性设置为“Embedded Resource”

3、代码中使用嵌入资源

// 获得正在运行类所在的名称空间

Type type = MethodBase.GetCurrentMethod().DeclaringType;

string _namespace = type.Namespace;

// 获得当前运行的 Assembly

Assembly _assembly = Assembly.GetExecutingAssembly();

// 根据名称空间和文件名生成资源名称

string resourceName = _namespace + ".directory.BitmapManifest.bmp";

// 根据资源名称从 Assembly 中获取此资源的 Stream

Stream stream = _assembly.GetManifestResourceStream(resourceName);

Image myImage = Image.FromStream(stream);

注意资源名称的组成规则：

项目默认名称空间 . 资源在项目中所在目录 . 资源文件名

上面代码中 BitmapManifest.bmp位图就在项目的 directory目录下。如果资源文件直接在项目根目录，则为 项目默认名称空间 . 资源文件名

再给一个xml资源的例子：

// 获得正在运行类所在的名称空间

Type type = MethodBase.GetCurrentMethod().DeclaringType;

string _namespace = type.Namespace;

// 获得当前运行的 Assembly

Assembly _assembly = Assembly.GetExecutingAssembly();

// 根据名称空间和文件名生成资源名称

string resourceName = _namespace + ".XMLFileTest.xml";

// 根据资源名称从 Assembly 中获取此资源的 Stream

Stream stream = _assembly.GetManifestResourceStream(resourceName);

 

XmlDocument xmlDoc = null;

xmlDoc = new XmlDocument();

xmlDoc.Load(stream);

二、 使用. resx资源文件嵌入资源

1、新建资源文件

在项目中新建一个资源文件，资源文件以.resx为后缀，同时还会新建一个跟资源文件同名的Designer.cs文件。

其实资源文件最大的用处是用来做多语言版本的软件时保存不同语言的资源，比如不同语言的菜单文本，可以把不同语言的字符串放在同一个资源类型下的不同资源包中，程序运行时根据运行时系统的culture选择不同的包显示不同语言的字符串。这里我们不关心多语言的资源的应用，所有略过这部分。

新建了资源文件后就能往资源文件中添加资源文件：

Figure.1 .resx资源文件可嵌入的资源类型

 

资源中可以添加字符串、位图、图标、音频、文件等等的资源。

添加的资源都会被保存在项目的Resources文件夹中。

2、设置资源文件的“BuildAction”属性

Resources文件夹中的所有资源文件的“BuildAction”属性设置为“Embedded Resource”。

3、资源存在方式

.resx资源文件管理的资源可以用两种存在形式，一种是以一般的文件形式存在于Resources文件夹中，另一个是经过Base64编码后嵌入到.resx资源文件中。

Figure.2 .resx资源文件中资源存在方式

 

打开.resx资源文件，选择资源，在属性中Persistence属性决定资源的存在形式。 资源的两种存在形式，在代码中调用都是一样的。

4、代码中使用嵌入资源

// 获得正在运行类所在的名称空间

Type type = MethodBase.GetCurrentMethod().DeclaringType;

string _namespace = type.Namespace;

// 获取当前主程序集

Assembly currentAssembly = Assembly.GetExecutingAssembly();

// 资源的根名称

string resourceRootName = _namespace + ".ResourceTest";

// 实例化资源管理类

ResourceManager resourceManager = new ResourceManager(resourceRootName, currentAssembly);

// 根据资源名获得资源对象

Icon myIcon = ( Icon)resourceManager.GetObject("IconTest");

注意资源的根名称的规则：

资源的根名称就是这个资源文件类的全名称。打开.resx资源文件相应的Designer.cs文件能看到资源类的全名称 ：名称空间.资源类名。

资源名：

资源名就是某个资源在.resx资源文件中的名称，打开.resx资源文件可以看到各个资源的名称。上面图中图标文件IconTest.ico的名称是IconTest。