詳細介紹Asp.Net Core MVC項目實現多語言的範例程式碼

本篇文章主要介紹了Asp.Net Core MVC項目實現多語言執行個體（Globalization/Localization） ，具有一定的參考價值，有興趣的可以瞭解一下

正好最近手上在給一個Razor MVC項目實現一個多語言功能，叫Globalization也好，Localization也好，whatever。最終要實現的效果呢，就是一鍵切換全站語言，並且開發的時候只需要寫一套頁面。

下面進入正題

首先，我們要建立一個CultureConfigurer類，用於管理本地化資源，完成“翻譯”環節：

這裡我用了靜態類，然後在MVC項目StartUp的時候執行Init()方法，其實有點蠢，當然你們也可以先寫一個介面然後用依賴注入成單例。

using System.Collections.Generic;using System.IO;using System.Reflection;using Newtonsoft.Json;namespace Localization{  public enum Culture  {    Cn,    En  }  public static class CultureConfigurer  {    private static Dictionary<string, string> _enDictionary;    private static Dictionary<string, string> _cnDictionary;    public static void Init()    {      var assembly = Assembly.Load(new AssemblyName("Localization"));      var resourceNames = assembly.GetManifestResourceNames();      foreach (var resourceName in resourceNames)      {        if (resourceName.EndsWith("en-US.json") || resourceName.EndsWith("zh-CN.json"))        {          using (var stream = assembly.GetManifestResourceStream(resourceName))          {            if (stream != null)            {              using (StreamReader reader = new StreamReader(stream))              {                var content = reader.ReadToEnd();                Dictionary<string, string> localizationDictionary =                  JsonConvert.DeserializeObject<Dictionary<string, string>>(content);                if (resourceName.EndsWith("en-US.json"))                {                  _enDictionary = localizationDictionary;                }                else                {                  _cnDictionary = localizationDictionary;                }              }            }          }        }      }    }    public static string GetValue(string key, Culture culture)    {      switch (culture)      {        case (Culture.Cn):          {            if (_cnDictionary.ContainsKey(key))            {              return _cnDictionary[key];            }            else            {              return $"[{key}]";            }          }        case (Culture.En):          {            if (_enDictionary.ContainsKey(key))            {              return _enDictionary[key];            }            else            {              return $"[{key}]";            }          }        default:          {            return $"[{key}]";          }      }    }  }}

這裡需要注意幾點：

　　1. enum類Culture用於代表要實現的語言，這裡我只是簡單的實現了中文和英文（其他我也不懂），對應的CultureConfigurer類就有中文和英文兩個Dictionary

　　2. 使用了Assembly.Load載入了程式集，參數為你自己的程式集名稱，我這裡就隨便寫了一個

　　3. 資源檔我選擇了json檔案，也是為了方便js中調用，當然你也可以用xml或者任何你想要用的格式，只需要調整解析方法，把檔案內容載入到對應的Dictionary中就可以了

　　4. 看到GetValue方法，相信大家都已經明白了，其實就是多語言不管是什麼語言，都用某個詞做key，然後調用這個方法“翻譯”成當前語言的詞。比如以“Open”作為Key，那麼中文Dictionary中就應該有一個KeyValuePair是"Open":"開啟"，而相應的英文中應該有一個"Open":"Open"，那麼Culture為中文時，顯示就是“開啟”，英文就是“Open”。

　　5. 資源檔可以建立在程式集中的任何位置，如果你的項目有project.json檔案，那麼就在buildOptions裡面添加，注意根據自己的檔案位置修改路徑

"embed": {   "include": [    "Localization/SourceFiles/*.json"   ]  }

如果是VS2017，是csproj檔案，那麼右擊要添加的資源檔，選擇“屬性”，配置改為“所有配置”，配置屬性的進階中“產生操作”修改為“內嵌資源”，如：

到這裡，我們已經寫好了實現本地化的核心類，下面要解決如何在頁面上顯示的問題：

在MVC項目中建立一個類MyRazorPage

using System;using Microsoft.AspNetCore.Mvc.Razor;using Localization;namespace MVC.Views{  public abstract class MyRazorPage<TModel> : RazorPage<TModel>  {    public virtual string L(string source)    {      var value = Context.Request.Cookies["culture"];      Culture c;      if (string.IsNullOrEmpty(value) || !Enum.TryParse(value, out c))      {        c = Culture.Cn;      }      return CultureConfigurer.GetValue(source, c);    }  }}

注意這個類是一個抽象類別，繼承了RazorPage<TModel>。然後在Views檔案夾下找到_ViewImports.cshtml檔案，在裡面添加一行“@inherits MVC.Views.MyRazorPage<TModel>”，這樣你的所有RazorPage就會繼承MyRazorPage這個類，也就是說你可以在MyRazorPage裡寫自己想要用的方法，在cshtml裡就可以直接調用啦。這裡我寫了一個L方法，調用了CultureConfigurer的GetValue方法。那麼，在頁面上需要翻譯的文字就只要寫成@L("Open")這樣的就可以啦。　　

可以看到，我是將使用者語言儲存在Cookie中的，這裡大家可以有各自的實現方法。我的實現方法很簡單，使用者切換語言的時候就訪問一個介面，修改了代表語言的Cookie，然後重新整理頁面就可以了。