[翻译]ASP.NET MVC 3 开发的20个秘诀（四）[20 Recipes for Programming MVC 3]：实现多语言支持

议题

互联网上有数以百万计来自数百个国家的人，同时也存在数百种不同的语言，甚至英国、美国、加拿大和英国之间也有多个不同的方言。不要让你的网站因为只提供一种语言而被限制浏览。

解决方案

创建资源文件，并添加Key/Value类型的静态文本，并实现CurrentUICulture以提供更改当前现实语言的能力。 

讨论

资源文件是XML文件，可以为网站存储多国语言。当你创建一个资源文件时会包含当前默认语言。在资源中创建一个键/值对文本后，你就可以在控制器、模型和视图中随处使用了。如图例 1-3 资源文件示例。

  

图例 1-3，资源文件示例

右键单击应用程序，选择“添加”->“新建文件夹”，将新文件命名为“Resources”。右键单击新文件夹，选择“添加”->“新建项”。在后侧搜索中输入“资源”并选择“资源文件”。

如上图所示，我们在资源文件中创建“Book”模型类的所有属性的条目。接下来我们需要修改模型类，使用DisplayAttribute引用这些值：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Data.Entity;
using System.ComponentModel.DataAnnotations;
using MvcApplication4.Validations; 

namespace MvcApplication4.Models
{

    public class Book
    {
        public int ID { get; set; }

        [Required]
        [Display(Name = "TitleDisplay",
        ResourceType = typeof(Resources.Resource1))]
        public string Title { get; set; } 

        [Display(Name = "IsbnDisplay",
        ResourceType = typeof(Resources.Resource1))]
        [Required]
        [IsbnValidation]
        public string Isbn { get; set; } 

        [Display(Name = "SummaryDisplay",
        ResourceType = typeof(Resources.Resource1))]
        [Required]
        public string Summary { get; set; } 

        [Display(Name = "AuthorDisplay",
        ResourceType = typeof(Resources.Resource1))]
        [Required]
        public string Author { get; set; } 

        [Display(Name = "ThumbnailDisplay",
        ResourceType = typeof(Resources.Resource1))]
        public string Thumbnail { get; set; } 

        [Display(Name = "PriceDisplay",
        ResourceType = typeof(Resources.Resource1))]
        [Range(1, 100)]
        public double Price { get; set; } 

        [Display(Name = "PublishedDisplay",
        ResourceType = typeof(Resources.Resource1))]
        [DataType(DataType.Date)]
        [Required]
        public DateTime Published { get; set; } 

    }

    public class BookDBContext : DbContext
    {
        public DbSet<Book> Books { get; set; }
    }

}

 

在上面这个例子中，DisplayAttribute使用键名字段在资源文件中检索引用相应的资源值。这样的引用可以在每个视图以及控制器上使用。

在接下来的例子中，我们将更改书籍索引视图的现实文本，将这些静态文本移动到资源文件中。如表1-1创建键/值对表：

键名	值
BookIndexTitle	索引
CreateLink	创建
EditLink	编辑
DetailsLink	详情
DeleteLink	删除

表 1-1 更新资源文件

目前为止只创建了一个资源文件，而其中所有的键名必须是整个项目唯一的。如你所见，在表中所创建的五个键值对，在所有视图中都可以链接使用。 

将资源文件更新完成后，打开BooksController并使用下面的代码替换Index()方法：

        //
        // GET: /Books/
        public ViewResult Index()
        {

            #region ViewBag Resources

            ViewBag.Title =
            Resources.Resource1.BookIndexTitle;

            ViewBag.CreateLink =
            Resources.Resource1.CreateLink;

            ViewBag.TitleDisplay =
            Resources.Resource1.TitleDisplay;

            ViewBag.IsbnDisplay =
            Resources.Resource1.IsbnDisplay;

            ViewBag.SummaryDisplay =
            Resources.Resource1.SummaryDisplay;

            ViewBag.AuthorDisplay =
            Resources.Resource1.AuthorDisplay;

            ViewBag.ThumbnailDisplay =
            Resources.Resource1.ThumbnailDisplay;

            ViewBag.PriceDisplay =
            Resources.Resource1.PriceDisplay;

            ViewBag.PublishedDisplay =
            Resources.Resource1.PublishedDisplay;

            ViewBag.EditLink =
            Resources.Resource1.EditLink;

            ViewBag.DetailsLink =
            Resources.Resource1.DetailsLink;

            ViewBag.DeleteLink =
            Resources.Resource1.DeleteLink;

            #endregion

            return View(db.Books.ToList());

        }

最后，书籍的索引目录视图必须将所有的文本改为ViewBag相应属性的引用：

@model IEnumerable<MvcApplication6.Models.Book>

<h2>@ViewBag.Title</h2>
<p>
    @Html.ActionLink((string)ViewBag.CreateLink, "Create")
</p>

<table>
    <tr>
        <th>
            @ViewBag.TitleDisplay
        </th>

        <th>
            @ViewBag.IsbnDisplay
        </th>

        <th>
            @ViewBag.SummaryDisplay
        </th>

        <th>
            @ViewBag.AuthorDisplay
        </th>

        <th>
            @ViewBag.ThumbnailDisplay
        </th>

        <th>
            @ViewBag.PriceDisplay
        </th>

        <th>
            @ViewBag.PublishedDisplay
        </th>
        <th></th>
    </tr>

    @foreach (var item in Model)
    {

        <tr>
            <td>
                @Html.DisplayFor(modelItem => item.Title)
            </td>

            <td>
                @Html.DisplayFor(modelItem => item.Isbn)
            </td>

            <td>
                @Html.DisplayFor(modelItem => item.Summary)
            </td>

            <td>
                @Html.DisplayFor(modelItem => item.Author)
            </td>

            <td>
                @Html.DisplayFor(modelItem => item.Thumbnail)
            </td>

            <td>
                @Html.DisplayFor(modelItem => item.Price)
            </td>

            <td>
                @Html.DisplayFor(modelItem => item.Published)
            </td>
            <td>
                @Html.ActionLink((string)ViewBag.EditLink,
                "Edit", new { id = item.ID }) |

                @Html.ActionLink((string)ViewBag.DetailsLink,
                "Details", new { id = item.ID }) |

                @Html.ActionLink((string)ViewBag.DeleteLink,
                "Delete", new { id = item.ID })                    

            </td>
        </tr>
    }

</table>

 

其他的视图和控制器都可以通过这样的方式修改，完成这些修改之后，我们只需要将资源文件复制成其他语言版本。

为了避免额外的输入，建议程序完成，所有文件都被添加到资源文件中。右键单击当前资源文件点击“复制”，然后，右键单击“Resources”文件夹点击“粘贴”，并将复制所得的资源副本文件重命名为“Resource1.fr.resx”，当然，也可以以你所希望的语言创建并命名其他副本。然后将这文件中的值得部分翻译成你所希望的语言文本。

要根据请求来变化语言，必须在Global.asax.cs文件的Appliation_AcquireRequestState()方法中通过改变每个请求的CurrentUICulture来实现：

       protected void Application_AcquireRequestState(
        object sender, EventArgs e)
        {

            if (HttpContext.Current.Session != null)
            {

                CultureInfo ci =
                (CultureInfo)this.Session["CurrentLanguage"];

                if (ci == null)
                {
                    ci = new CultureInfo("en");
                    this.Session["CurrentLanguage"] = ci;
                }

                Thread.CurrentThread.CurrentUICulture = ci;

                Thread.CurrentThread.CurrentCulture =
                CultureInfo.CreateSpecificCulture(ci.Name);
            }
        }

在上面的代码示例中，经过检测之后会将有效的CultureInfo赋值给会话变量CurrentLanguage，如果为检测到有效的CultureInfo，系统会默认将英文赋予CurrentLanguage。接下来，我们会在Home控制器中创建一个动作，为用户提供选择语言的功能：

       

        public ActionResult ChangeLanguage(string language)
        {
            Session["CurrentLanguage"] =
            new CultureInfo(language);

            return Redirect("Index");
        }

ChangeLanguage接受设置新语言名称的参数，这个参数变量会更新Global.asax.cs中的绘画变量，然后切换至用户选中语言界面。将下面的链接添加到全局共享母版页_Layout.cshtml中：

[ @Html.ActionLink("English", "ChangeLanguage", "Home",
new { language = "en" }, null) ]
        
[ @Html.ActionLink("Français", "ChangeLanguage", "Home",
new { language = "fr" }, null) ]

我们将链接放置在“登录”链接的旁边，这样随着网站的逐步发展，创建一个新的资源文件，添加一个新的链接，这样用户就可以选择一种新的语言了，添加一种新语言非常容易。

在之前我们讨论过加拿大、美国、英国等国家有和很多不同的英语方言，如果想为不同的国家添加语言信息，可以在国家的代码后面添加语言代码，并通过字符“-”连接起来。例如，“en-GB”表示英国英语，添加之后还需要更新链接、语言名称以及CurrentUICulture设置。

参考信息

CurrentUICulture 原书地址 书籍源代码