首頁  >  文章  >  後端開發  >  詳細介紹Asp.Net Core MVC專案實作多語言的範例程式碼

詳細介紹Asp.Net Core MVC專案實作多語言的範例程式碼

黄舟
黄舟原創
2017-06-04 09:48:172684瀏覽

本篇文章主要介紹了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);
    }
  }
}

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

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

以上是詳細介紹Asp.Net Core MVC專案實作多語言的範例程式碼的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn