不同的語言設定, 在網頁上是平常的事, 在ASP.net MVC 上套入, 也不太複雜, 方法如下:
- 於Visual Studio, 建立一個新Project, 於Web中選擇ASP.net Web Application (.NET Framework);
- 選取MVC 並按OK;
- 建立一個文件夾, 命為Resources, 並建立Resources File 於此. 它用作存取不同的語言, 然而, 它須要跟著一個語法命名:
Resources.<<CultureCode>>.resx
Culture Code 可以從Reference中找到. 但第一個則必須命名為Resources.resx 以作預設值.
用Notepad++打開Resource File 後, 內容如下, 亦因此可以讓user 直接修改.
Resource.resx 內容:
- 於文件夾 /Model中, 建立一個新Class 並命為Person.cs, 之後輸入以下代碼:
public class Person { [Display(Name = "FirstName", ResourceType = typeof(Resources.Resources))] [Required(ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "FirstNameRequired")] [StringLength(50, ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "FirstNameLong")] public string FirstName { get; set; } [Display(Name = "LastName", ResourceType = typeof(Resources.Resources))] [Required(ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "LastNameRequired")] [StringLength(50, ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "LastNameLong")] public string LastName { get; set; } [Display(Name = "Age", ResourceType = typeof(Resources.Resources))] [Required(ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "AgeRequired")] [Range(0, 130, ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "AgeRange")] public int Age { get; set; } [Display(Name = "Email", ResourceType = typeof(Resources.Resources))] [Required(ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "EmailRequired")] [RegularExpression(".+@.+\\..+", ErrorMessageResourceType = typeof(Resources.Resources), ErrorMessageResourceName = "EmailInvalid")] public string Email { get; set; } [Display(Name = "Biography", ResourceType = typeof(Resources.Resources))] public string Biography { get; set; } }
- 其後建立BaseController, 以用作辨認Language Settings.
public class BaseController : Controller { protected override IAsyncResult BeginExecuteCore(AsyncCallback callback, object state) { string cultureName = null; // Attempt to read the culture cookie from Request HttpCookie cultureCookie = Request.Cookies["_culture"]; if (cultureCookie != null) cultureName = cultureCookie.Value; else cultureName = Request.UserLanguages != null && Request.UserLanguages.Length > 0 ? Request.UserLanguages[0] : // obtain it from HTTP header AcceptLanguages null; // Validate culture name cultureName = CultureHelper.GetImplementedCulture(cultureName); // This is safe // Modify current thread's cultures Thread.CurrentThread.CurrentCulture = new System.Globalization.CultureInfo(cultureName); Thread.CurrentThread.CurrentUICulture = Thread.CurrentThread.CurrentCulture; return base.BeginExecuteCore(callback, state); } }
- 建立文件夾Helper, 並在其中建立Class, 命名為CultureHelper:
public static class CultureHelper { // Valid cultures private static readonly List<string> _validCultures = new List<string> { "af", "af-ZA", "sq", "sq-AL", "gsw-FR", "am-ET", "ar", "ar-DZ", "ar-BH", "ar-EG", "ar-IQ", "ar-JO", "ar-KW", "ar-LB", "ar-LY", "ar-MA", "ar-OM", "ar-QA", "ar-SA", "ar-SY", "ar-TN", "ar-AE", "ar-YE", "hy", "hy-AM", "as-IN", "az", "az-Cyrl-AZ", "az-Latn-AZ", "ba-RU", "eu", "eu-ES", "be", "be-BY", "bn-BD", "bn-IN", "bs-Cyrl-BA", "bs-Latn-BA", "br-FR", "bg", "bg-BG", "ca", "ca-ES", "zh-HK", "zh-MO", "zh-CN", "zh-Hans", "zh-SG", "zh-TW", "zh-Hant", "co-FR", "hr", "hr-HR", "hr-BA", "cs", "cs-CZ", "da", "da-DK", "prs-AF", "div", "div-MV", "nl", "nl-BE", "nl-NL", "en", "en-AU", "en-BZ", "en-CA", "en-029", "en-IN", "en-IE", "en-JM", "en-MY", "en-NZ", "en-PH", "en-SG", "en-ZA", "en-TT", "en-GB", "en-US", "en-ZW", "et", "et-EE", "fo", "fo-FO", "fil-PH", "fi", "fi-FI", "fr", "fr-BE", "fr-CA", "fr-FR", "fr-LU", "fr-MC", "fr-CH", "fy-NL", "gl", "gl-ES", "ka", "ka-GE", "de", "de-AT", "de-DE", "de-LI", "de-LU", "de-CH", "el", "el-GR", "kl-GL", "gu", "gu-IN", "ha-Latn-NG", "he", "he-IL", "hi", "hi-IN", "hu", "hu-HU", "is", "is-IS", "ig-NG", "id", "id-ID", "iu-Latn-CA", "iu-Cans-CA", "ga-IE", "xh-ZA", "zu-ZA", "it", "it-IT", "it-CH", "ja", "ja-JP", "kn", "kn-IN", "kk", "kk-KZ", "km-KH", "qut-GT", "rw-RW", "sw", "sw-KE", "kok", "kok-IN", "ko", "ko-KR", "ky", "ky-KG", "lo-LA", "lv", "lv-LV", "lt", "lt-LT", "wee-DE", "lb-LU", "mk", "mk-MK", "ms", "ms-BN", "ms-MY", "ml-IN", "mt-MT", "mi-NZ", "arn-CL", "mr", "mr-IN", "moh-CA", "mn", "mn-MN", "mn-Mong-CN", "ne-NP", "no", "nb-NO", "nn-NO", "oc-FR", "or-IN", "ps-AF", "fa", "fa-IR", "pl", "pl-PL", "pt", "pt-BR", "pt-PT", "pa", "pa-IN", "quz-BO", "quz-EC", "quz-PE", "ro", "ro-RO", "rm-CH", "ru", "ru-RU", "smn-FI", "smj-NO", "smj-SE", "se-FI", "se-NO", "se-SE", "sms-FI", "sma-NO", "sma-SE", "sa", "sa-IN", "sr", "sr-Cyrl-BA", "sr-Cyrl-SP", "sr-Latn-BA", "sr-Latn-SP", "nso-ZA", "tn-ZA", "si-LK", "sk", "sk-SK", "sl", "sl-SI", "es", "es-AR", "es-BO", "es-CL", "es-CO", "es-CR", "es-DO", "es-EC", "es-SV", "es-GT", "es-HN", "es-MX", "es-NI", "es-PA", "es-PY", "es-PE", "es-PR", "es-ES", "es-US", "es-UY", "es-VE", "sv", "sv-FI", "sv-SE", "syr", "syr-SY", "tg-Cyrl-TJ", "tzm-Latn-DZ", "ta", "ta-IN", "tt", "tt-RU", "te", "te-IN", "th", "th-TH", "bo-CN", "tr", "tr-TR", "tk-TM", "ug-CN", "uk", "uk-UA", "wen-DE", "ur", "ur-PK", "uz", "uz-Cyrl-UZ", "uz-Latn-UZ", "vi", "vi-VN", "cy-GB", "wo-SN", "sah-RU", "ii-CN", "yo-NG" }; // Include ONLY cultures you are implementing private static readonly List<string> _cultures = new List<string> { "en-US", // first culture is the DEFAULT "es", // Spanish NEUTRAL culture "ar" // Arabic NEUTRAL culture }; /// <summary> /// Returns true if the language is a right-to-left language. Otherwise, false. /// </summary> public static bool IsRighToLeft() { return System.Threading.Thread.CurrentThread.CurrentCulture.TextInfo.IsRightToLeft; } /// <summary> /// Returns a valid culture name based on "name" parameter. If "name" is not valid, it returns the default culture "en-US" /// </summary> /// <param name="name" />Culture's name (e.g. en-US)</param> public static string GetImplementedCulture(string name) { // make sure it's not null if (string.IsNullOrEmpty(name)) return GetDefaultCulture(); // return Default culture // make sure it is a valid culture first if (_validCultures.Where(c => c.Equals(name, StringComparison.InvariantCultureIgnoreCase)).Count() == 0) return GetDefaultCulture(); // return Default culture if it is invalid // if it is implemented, accept it if (_cultures.Where(c => c.Equals(name, StringComparison.InvariantCultureIgnoreCase)).Count() > 0) return name; // accept it // Find a close match. For example, if you have "en-US" defined and the user requests "en-GB", // the function will return closes match that is "en-US" because at least the language is the same (ie English) var n = GetNeutralCulture(name); foreach (var c in _cultures) if (c.StartsWith(n)) return c; // else // It is not implemented return GetDefaultCulture(); // return Default culture as no match found } /// <summary> /// Returns default culture name which is the first name decalared (e.g. en-US) /// </summary> /// <returns></returns> public static string GetDefaultCulture() { return _cultures[0]; // return Default culture } public static string GetCurrentCulture() { return Thread.CurrentThread.CurrentCulture.Name; } public static string GetCurrentNeutralCulture() { return GetNeutralCulture(Thread.CurrentThread.CurrentCulture.Name); } public static string GetNeutralCulture(string name) { if (!name.Contains("-")) return name; return name.Split('-')[0]; // Read first part only. E.g. "en", "es" } }
- 之後修改/Controllers/HomeController內容如下:
public class HomeController : BaseController { [HttpGet] public ActionResult Index() { return View(); } [HttpPost] public ActionResult Index(Person per) { return View(); } public ActionResult SetCulture(string culture) { // Validate input culture = CultureHelper.GetImplementedCulture(culture); // Save culture in a cookie HttpCookie cookie = Request.Cookies["_culture"]; if (cookie != null) cookie.Value = culture; // update cookie value else { cookie = new HttpCookie("_culture"); cookie.Value = culture; cookie.Expires = DateTime.Now.AddYears(1); } Response.Cookies.Add(cookie); return RedirectToAction("Index"); } }
- 之後修改”/Views/Home/index.cshtml” 內容如下:
@model PoC.MultiLanguage.Models.Person @using PoC.MultiLanguage.Resources @{ ViewBag.Title = "Home Page"; var culture = System.Threading.Thread.CurrentThread.CurrentUICulture.Name.ToLowerInvariant(); } @helper selected(string c, string culture) { if (c == culture) { @:checked="checked" } } <h2>@Resources.AddPerson</h2> @using (Html.BeginForm("SetCulture", "Home")) { <fieldset> <legend>@Resources.ChooseYourLanguage</legend> <div class="control-group"> <div class="controls"> <label for="en-us"> <input name="culture" id="en-us" value="en-us" type="radio" @selected("en-us", culture) /> English </label> </div> </div> <div class="control-group"> <div class="controls"> <label for="es"> <input name="culture" id="zh-hk" value="zh-hk" type="radio" @selected("zh-hk", culture) /> Hong Kong </label> </div> </div> </fieldset> } @using (Html.BeginForm()) { @Html.AntiForgeryToken() <div class="form-horizontal"> <hr /> @Html.ValidationSummary(true) <div class="form-group"> @Html.LabelFor(model => model.FirstName, new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.FirstName) @Html.ValidationMessageFor(model => model.FirstName) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.LastName, new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.LastName) @Html.ValidationMessageFor(model => model.LastName) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Age, new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Age) @Html.ValidationMessageFor(model => model.Age) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Email, new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Email) @Html.ValidationMessageFor(model => model.Email) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Biography, new { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Biography) @Html.ValidationMessageFor(model => model.Biography) </div> </div> <div class="form-group"> <div class="col-md-offset-2 col-md-10"> <input type="submit" value="@Resources.Create" class="btn btn-default" /> </div> </div> </div> } @section Scripts { @Scripts.Render("~/bundles/jqueryval") <script type="text/javascript"> (function ($) { $("input[type = 'radio']").click(function () { $(this).parents("form").submit(); // post form }); })(jQuery); </script> }
執行結果(因為懶, 故加[TC require] 表示分別):
英文 (EN) | 中文 (ZH-HK) |
Reference
ASP.NET MVC 5 Internationalization, Nadeem Afana’s Blog
Table of Language Culture Names, Codes, and ISO Values Method, Microsoft
Leave a Reply