基于ASP.NET实现全球化

因为项目的关系，这两天一直在研究ASP.NET的全球化问题。我知道，在JAVA体系中有专门的I18N处理方案，.NET中不可能会没有。所以，到网上查了查资料，经过一番“苦斗”，略有小成。感觉网上目前还没有非常完整的解决方案(也可能是我没有发现)，遂花了点时间总结一下经验教训，希望与大家共享之。若有什么不足之处，请各位多多指教。

    本文中，将以在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文件的结构如下：


   ...
 
  欢迎
 
   ...

    这儿有一点需要说明，如果你不是希望通过修改配置文件动态的切换语种，而是希望通过设置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元素与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。