一、ASP.NET MVC的本地化支援
ASP.NET MVC的是基於ASP.NET運行,所以由ASP.NET提供的所有功能,都可以在MVC裡使用,例如緩衝,工作階段狀態和本地化。 在傳統的ASP.NET Web表單時代我們使用資源檔儲存不同語言中的內容和使用由Visual Studio自動產生的ResourceManager類來檢索它們。在ASP.NET MVC他們一樣有效。
讓我建立一個標準的ASP.NET MVC的一個應用程式範例。該網站是中文的,我們可以看到所有的內容都是在視圖和控制器類裡寫死的。
我使用的架構是mvc3的基於Razor模板的網站。
使用Visual Studio 2010 建立 MVC3的Web應用程式,在隨後出現的選擇中選擇Internet 應用程式,視圖引擎為Razor;
可以看出來現在網站是中文的,而且我們可以看到所有的內容在視圖和控制器裡都是硬式編碼。
現在我需要做的是把所有的內容從頁面和控制器裡分離出來,Asp.Net給我們一個名為App_GlobalResources的檔案,它裡麵包含各種語言的全域資源檔。我們只需要在解決方案管理器裡的Web項目上右擊滑鼠,添加->添加至Asp.Net檔案夾->App_GlobalResources
我建立了中文、英文兩個語言的資源檔,中文是程式的預設語言,所以我先建立Global.resx檔案,然後是Global.en.resx,中間的“en”是英語的Culture Name。如果你需要法語,那麼你只需要再建立Global.fr.resx檔案,Visual Studio會自動產生對應的類。
現在讓我在資源檔裡添加一些內容,在首頁上我們需要替換三處:標題、訊息還有描述,所以我們在這兩個資源檔裡添加3個項。
標題和描述都在視圖頁面裡定義了,所以我將更改視圖。
複製代碼 代碼如下:
@{
ViewBag.Title = Resources.Global.Home_Index_Title;
}
<h2>@ViewBag.Message</h2>
<p>
@Resources.Global.Home_Index_Desc
<a href="http://asp.net/mvc" title="@Resources.Global.Home_Index_DescLink">http://asp.net/mvc</a>。
</p>
複製代碼 代碼如下:
public ActionResult Index()
{
ViewBag.Message = Resources.Global.Home_Index_Message;
return View();
}
二、通過URL指定語言
我們已經把內容轉移到了資源檔,但是我們的程式還不支援本地化,因為沒有任何地方我們可以設定指定語言的地方。為了簡單起見,我們將使用url來標明選擇使用的語言(就類似微軟網站),意思就是如果我的URL是http://localhost/en-US/Home/Index ,則網站會體現為英文;而http://localhost/zh-CN/Home/Index 則是簡體中文。使用者可以在任何停留的頁面更改語言,而且 當他想共用網址的時候也會保留語言設定。
為了達到效果,我更改了程式的路由,在最前頭新增一個名為“lang”的路由規則:
複製代碼 代碼如下:
public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.MapRoute(
"Localization", // 路由名稱
"{lang}/{controller}/{action}/{id}", // 帶有參數的 URL
new { controller = "Home", action = "Index", id = UrlParameter.Optional }//參數預設值
);
routes.MapRoute(
"Default", // 路由名稱
"{controller}/{action}/{id}", // 帶有參數的 URL
new { controller = "Home", action = "Index", id = UrlParameter.Optional } // 參數預設值
);
}
要注意,代碼裡並沒有設定lang的預設值,而且沒有刪除預設的路由,這個是為了防止如 http://localhost/ and http://localhost/Home/Index之類地址時程式無法解析。
因為我們需要URL設定語言,所以我們需要在每個action執行前執行寫邏輯處理,這裡ActionFilter將是個不錯的解決方案。
複製代碼 代碼如下:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using System.Threading;
using System.Globalization;
namespace ShaunXu.MvcLocalization
{
public class LocalizationAttribute : ActionFilterAttribute
{
public override void OnActionExecuting(ActionExecutingContext filterContext)
{
if (filterContext.RouteData.Values["lang"] != null &&
!string.IsNullOrWhiteSpace(filterContext.RouteData.Values["lang"].ToString()))
{
///從路由資料(url)裡設定語言
var lang = filterContext.RouteData.Values["lang"].ToString();
Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(lang);
}
else
{
///從cookie裡讀取語言設定
var cookie = filterContext.HttpContext.Request.Cookies["ShaunXu.MvcLocalization.CurrentUICulture"];
var langHeader = string.Empty;
if (cookie != null)
{
///根據cookie設定語言
langHeader = cookie.Value;
Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(langHeader);
}
else
{
///如果讀取cookie失敗則設定預設語言
langHeader = filterContext.HttpContext.Request.UserLanguages[0];
Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(langHeader);
}
///把語言值設定到路由值裡
filterContext.RouteData.Values["lang"] = langHeader;
}
/// 把設定儲存進cookie
HttpCookie _cookie = new HttpCookie("ShaunXu.MvcLocalization.CurrentUICulture", Thread.CurrentThread.CurrentUICulture.Name);
_cookie.Expires = DateTime.Now.AddYears(1);
filterContext.HttpContext.Response.SetCookie(_cookie);
base.OnActionExecuting(filterContext);
}
}
}
我建立了一個繼承自ActionFilterAttribute的"LocalizationAttribute"並重寫了OnActionExecuting方法的屬性,首先檢查路由裡的值,如果包含了語言設定,則設定當前進程的目前範圍值,它指示資源管理員(Visual Studio根據資源檔自動產生)擷取相關的值。如果找不到路由裡的語言值,則讀取cookie值來設定,否則使用預設語言。最後把值放進路由,並儲存到cookie裡。
我在home控制器裡使用這個屬性這樣所有action都可以執行我的本地化邏輯。
複製代碼 代碼如下:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using ShowLocal.Models;
namespace ShowLocal.Controllers
{
[Localization]
public class HomeController : Controller
{
public ActionResult Index()
{
ViewBag.Message = Resources.Global.Home_Index_Message;
return View();
}
public ActionResult About()
{
return View();
}
}
}
選擇我們可以啟動網站然後添加語言在URL上看看結果