在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