基于ASP.NET实现全球化
时间:2005-08-16 来源:nicolaus
本文中,将以在VS.Net2002中创建一个实际项目的方式来描述在ASP.NET中实现全球化的基本步骤和需要注意的地方。
第一步,我们创建一个名为TestRM的Web Application。这个项目将缺省包含
- AssemblyInfo.cs
- TestRM.csproj
- TestRM.csproj.webinfo
- TestRM.sln
- TestRM.suo
- TestRM.vsdisco
- WebForm1.aspx(包含aspx.cs和aspx.resx)
- Global.asax(包含asax.cs和asax.resx)
- Web.Config
第二步,需要为项目创建若干不同语种的资源文件。在.Net中,资源文件的扩展名是.resx,此文件是基本于XML的,VS.NET提供了非常方便的资源文件编辑工具(个人感觉很象XmlSpy),这儿就不多说了。在此,以简体中文(zh-cn)和美国英语(en-us)为例。通过“项目->添加新项->资源文件”向项目中分别添加名为string.en-us.resx和string.zh-cn.resx的资源文件,并在string.en-us.resx中添加一条记录,内容是name:String001;value:Welcome,在string.zh-cn.resx中添加一条记录name:String001;value:欢迎。其XML文件的结构如下:
<?xml version="1.0" encoding="utf-8" ?>
<root>
...
<data name="String001">
<value>欢迎</value>
</data>
...
</root>
这儿有一点需要说明,如果你不是希望通过修改配置文件动态的切换语种,而是希望通过设置Windows的“区域设置”功能来切换语种的话,请跳过第三步。(有这种需求吗???-_-)
这样,当此项目被编译后,在bin目录下将为出现en-us和zh-cn两个子目录,其中分别有一个dll文件。名为TestRM.resources.dll。
第三步,修改Global.asax和Web.Config文件以实现动态切换语种。
首先,我们需要在Global.asax的Application_BeginRequest事件中添加如下代码:
protected void Application_BeginRequest(Object sender, EventArgs e)
{
Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(ConfigurationSettings.AppSettings["DefaultCulture"]);
}
这是最简单的应用,当然,你可以将一些配置项存储到Cookie之中。
然后,在Web.Config中添加如下代码:
<appSettings>
<add key="DefaultCulture" value="zh-cn" />
</appSettings>
注意,appSettings元素与system.web属于同一层次。
最后,在WebForm1的Page_Load事件中加入如下代码:
public class WebForm1 : System.Web.UI.Page
{
private void Page_Load(object sender, System.EventArgs e)
{
WebForm1 form1 = new WebForm1();
ResourceManager resManager = new ResourceManager(form1.GetType().Namespace + ".string", form1.GetType().Assembly);
System.Globalization.CultureInfo ci = System.Threading.Thread.CurrentThread.CurrentCulture;
Response.Write(resManager.GetString("String001",ci));
}
...
}
请大家注意上面这段代码中有下划线的这行代码,在VS.NET 2002中,如果使用this.GetType().Namespace和this.GetType().Assembly.FullName得到竟然是ASP和6fqpc_hh, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null,获得的Assembly显然是随机产生。但在c#的类文件和WinForm中是正常的,不清楚是什么原因。结果当然不用说,肯定是找不到相应的资源文件的。
此外,需要强调的一点是,这儿使用了form1.GetType().Namespace + ".string",如果资源文件不是被放置在项目根目录下,而是被放在某个子目录下时,请注意修改项目的缺省命名空间。因为,资源文件被编译后,在项目的资源文件TestRM.resources.dll的Manifest(用ILDASM查看)中会有如下一行,.mresource public 'TestRM.string.zh-CN.resources'或.mresource public 'TestRM.string.en-US.resources'。其基本的构成规则是项目缺省命名空间+资源文件所在目录名+资源文件名[+语种],如果一种项目的资源文件不分语种,如:我们定义了一个名为string.resx的资源文件,此时,编译项目后在bin目录下将不再会产生诸如zh-CN和en-US之类的子目录,资源文件将被直接嵌入项目的Assembly中。同时,在项目的Assembly的Manifest中会有如下一行.mresource public 'TestRM.string.resources'。所以,如果资源文件不是放在项目的根目录,且缺省命名空间没有被改变的话,在试图使用resManager.GetString时将会被提示“无法访问任何语种的资源文件”,原因就是上面所说的。
基本上,上述的这些就是我在研究基于ASP.NET实现全球化时的一些心得,希望能对一些朋友有所帮助。
软件要广泛的发布,就要支持多语言。
使用.net的resX文件来实现多语言是一个不错的选择。
这是使用Web中使用多语言的一个例子。
效果是:在国内访问的话,看到这样的显示:
UserLanguages : zh-cn
based on ur cultrue, u should see this word : 汉字:
如果在英语国家访问的话
UserLanguages : en-us
based on ur cultrue, u should see this word : English Word
Web项目名叫ChineseWordTest。建立了两个资源文件,分别是MultiLang.en-us.resx和MultiLang.zh-cn.resx。资源文件里面都有一个键值对Test_Word。en-us的那个里面值是“English Word”,MultiLang.zh-cn.resx里面写的是“汉字:”。
下边是代码
---------------------------------code------------------------
public class WebForm1 : System.Web.UI.Page
{
protected System.Web.UI.WebControls.Label Label2;
protected System.Web.UI.WebControls.Label Label1;
private void Page_Load(object sender, System.EventArgs e)
{
string clientCultrue=Request.UserLanguages[0].ToString();
this.Label1.Text="UserLanguages : "+ clientCultrue;
try
{
//使用客户的浏览器的默认语言来确定显示
Thread.CurrentThread.CurrentUICulture=new System.Globalization.CultureInfo(clientCultrue);
}
catch
{
//如果失败,就使用默认语言展示给用户。
Thread.CurrentThread.CurrentUICulture=new System.Globalization.CultureInfo("en-us");
}
Assembly assembly;
ResourceManager rmManager;
assembly = Assembly.GetExecutingAssembly();
rmManager = new ResourceManager("ChineseWordTest.MultiLang", assembly);
string str = rmManager.GetString("Test_Word");
this.Label2.Text="based on ur cultrue, u should see this word : "+str;
}
------------------------------------end code-------------------------
注意:
1:资源文件的命名规则。一定是这样子的了:xxx.文化代码.resx.比如MultiLang.zh-cn.resx。MultiLang是资源名,zh-cn是简体中文的代码。
2:资源文件好像只能放在根目录下,一旦放进一个文件夹里,好像就出错。
3:引用时: new ResourceManager("ChineseWordTest.MultiLang", assembly); 格式是:项目名.资源名。 ChineseWordTest是Web项目的名称,MultiLang使资源文件的名称。 至于该调用那一个资源文件,是汉语还是英语,由Thread.CurrentThread.CurrentUICulture来确定,只要指定了这个Cultrue,framework就会自动调用你的不同文化的资源文件了。
4:如果成功的话,编译成功后会在bin文件夹下创建en-us,zh-cn文件夹。发布时不要改变这个结构。
5:我是使用的string clientCultrue=Request.UserLanguages[0].ToString();来获取用户的语言代码的。根据发送请求的用户的浏览器的语言列表的第一个来确定。如果失败,证明还没有这个语言包,那么就使用默认语言包(英语)。
以上是在vs2003下测试通过。
如果要在asp.net2.0中使用,则稍有不同。
这时放在Global.asax中的代码。
--------------------------------------code----------------------
void Session_Start(Object sender, EventArgs e)
{
// Code that runs when a new session is started
//new a resource manager for each session
string clientCultrue = Request.UserLanguages[0].ToString();
try
{
//使用客户的浏览器的默认语言来确定显示
Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo(clientCultrue);
}
catch
{
//如果失败,就使用默认语言展示给用户。
Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("en-us");
}
ResourceManager rmManager;
rmManager = Resources.MultiLang.ResourceManager;
Session.Add("ResourceManager", rmManager);
}
-------------------------end code-----------------------
注意:
1:asp.net2.0中应该如此使用:
rmManager = Resources.MultiLang.ResourceManager;
而不是在Assembly中取:
assembly = Assembly.GetExecutingAssembly();
rmManager = new ResourceManager("ChineseWordTest.MultiLang", assembly);
2:2.0中创建资源文件时,必须创建一个MultiLang.resx,然后再创建MultiLang.en-us.resx和MultiLang.zh-cn.resx。如果没有MultiLang.resx,则系统就找不到该资源。MultiLang.resx里面可以什么都不写,但是必须得有。
3:访问资源可以Resources.MultiLang.Key。
有了资源文件(必须是如此命名的:xxx.resx。而不能是xxx.语言.resx)之后, 代码文件中写入Resources.就可以自动找到该资源名称xxx。继而可以直接引用资源中的key。