在C#中有多种使用资源文件的方法,能够很方便地开发全球通用的应用程序。本文通过一个简单的小例子,来讲解在C#中如何利用资源文件,快速开发一个多种语言版本的程序。本例中只有一个窗体,三个控件,能够根据用户的设置以中文或英文界面运行。开发环境是Windows 2000 Professional、Microsoft Visual Studio.NET 2002。具体开发步骤如下:
一、新建项目
启动Microsoft Visual Studio .NET,新建一个C#项目MyApp,本例工程存放于F:\Csharp\MyApp。
二、添加控件
在Form1 窗体上添加三个控件(见图1):主菜单MainMenu、标签Label1和按钮Button1。Label1和Button1控件的属性均采用缺省设置。MainMenu控件中添加三个菜单项menuItem1、menuItem2、menuItem3。Text属性分别设为“语言”、“中文”和“English”。menuItem2、
menuItem3 的RadioCheck属性设为True。
图 1
三、创建配置文件
在项目中添加一个文本文件MyAppConfig.ini,保存当前程序的语言版本设置。该文件中只有一行内容。如果是“English”,则表示程序为英文版;如果是“Chinese”则为中文版。这里暂且保存为“English”。
四、创建资源文件
.NET中的资源文件有三种: 文本(.txt )文件、XML 格式的.Resx 文件和.Resources 文件。文本文件只能包含形如“ 名称= 值”格式的字符串资源。.Resx文件和.Resources 文件中不仅能保存字符串资源,还能保存图像等可序列化的持久对象资源。但是只有.resources 文件格式的资源文件才能被嵌入到运行库可执行文件中,或被编译为附属程序集。利用Visual Studio .NET 中自带的资源文件生成器
(Resgen.exe),可以将.txt文件和.Resx文件转换为.resources 文件格式。本例中只用到了字符串资源,所以在项目中添加两个文本文件Resource_zh.txt 和Reource_en.txt。
Reource_en.txt 文件中的内容:
menuItem1_Name=Language
button1_Name=Exit
label1_Text=This is English version!
Resource_zh.txt 文件中的内容:
menuItem1_Name=语言
button1_Name=退出
label1_Text=这是中文版!
需要注意的是Resource_zh.txt文件中含有汉字,必须以UTF-8编码保存。在Visual Studio .NET集成开发环境中,可以先点击“文件”菜单中的“高级保存选项”,选中UTF-8编码格式,再保存文件。
然后,点击“程序”菜单中的“Visual Studio .NET命令提示”菜单,进入DOS方式,输入以下两行命令,生成程序中能够访问的资源文件MyApp.resources和MyApp.zh-CN.resources。英文资源文件MyApp.resources 作为默认的后备资源文件。MyApp.zh-CN.resources
是中文资源文件,文件名中的“MyApp”是资源文件的根名称,必须与后备资源文件的根名称相同,“zh-CN”指定资源文件的区域性。
F:\Csharp\MyApp>resgen Resource_en.txt,MyApp.resources
F:\Csharp\MyApp>resgen Resource_zh.txt,MyApp.zh-CN.
resources
五、修改代码
1、在代码的开头添加需引用的命名空间。
using System.Globalization;
using System.Resources;
using System.Threading;
using System.IO;
2、在Form1 中定义两个字段ci和rm。CultureInfo对象ci用来指定读取资源文件时的区域性。ResourceManager对象rm用来在指定的资源文件中读取资源。
CultureInfo ci = new CultureInfo("");
Res ource Manag er rm = Res ource Manag er.CreateFileBasedResourceManager("MyAPP", ".", null);
3、在Form1中添加一个方法ReadResources,用来读取相应资源文件中的字符串资源,来修改界面菜单、标签和按钮上文字显示。
private void ReadResources(){
this.menuItem1.Text = rm.GetString("menuItem1_Text",ci) ;
this.button1.Text = rm.GetString("button1_Text",ci);
this.label1.Text = rm.GetString("label1_Text",ci);
this.Refresh();
}
4、在Form1 的Load事件处理过程中,根据配置文件的内容,调用ReadResources方法,读取资源,显示程序界面。
private void Form1_Load(...) {
StreamReader sr=File.OpenText("MyAppConfig.ini");
if (sr.ReadLine()=="Chinese"){
ci = new CultureInfo("zh-CN");
menuItem2.Checked=true; }
else {
ci = new CultureInfo("en");
menuItem3.Checked=true;
}
sr.Close();
this.ReadResources();
}
5、在Form1 中添加一个方法SaveConfig,用来修改配置文件。在menuItem2 和menuItem3 的Click事件过程中调用S a v e C o n f i g 方法,分别将字符串“Chinese”、“English ”写入配置文件,并调用ReadResources方法,来更新界面。
private void SaveConfig(string p_Language){
StreamWriter sw=File.CreateText("MyAppConfig.ini");
sw.WriteLine(p_Language);
sw.Close();
}
private void menuItem2_Click(...){
this.SaveConfig("Chinese");ci = new CultureInfo("zh-CN");
menuItem2.Checked=true; menuItem3.Checked=false;
this.ReadResources();
}
private void menuItem3_Click(...){
this.SaveConfig("English");
ci = new CultureInfo("en");
menuItem2.Checked=false;
menuItem3.Checked=true;
this.ReadResources();
}
6、在按钮button1的Click事件过程中,关闭窗体,结束运行程序。
private void button1_Click(...)
{
this.Close();
}
六、编译并运行程序
如果手工编译源程序,只需点击“Visual Studio.NET 命令提示”菜单,进入DOS方式,输入下面命令,即可生成二进制的可执行文件MyApp.exe,然后输入MyApp,就能运行程序。
F:\Csharp\MyApp>csc /out:MyApp.exe form1.cs
如果是在Microsoft Visual Studio .NET 集成开发环境中运行程序,将自动进行编译,并将编译的二进制可执行文件放到bin\Debug子目录下。此时,需要注意的是要将MyAppConfig.ini、MyApp.resources 和MyApp.zh-CN.resources 这三个文件也复制到bin\Debug\子目录下,程序才能正常运行。
程序第一次运行时,是英文界面(见图2),点击菜单“中文”,将变成中文界面(见图3)。单击按钮“Exit”,退出程序后,再次运行程序时,直接显示中文界面。
图2
图3