ASP.NET MVC的Localization本地化多語言支援_自學過程

來源:互聯網
上載者:User

一、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上看看結果

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.