Asp.Net Core MVC項目實現(xiàn)多語言實例(Globalization/Localization)
正好最近手上在給一個Razor MVC項目實現(xiàn)一個多語言功能,叫Globalization也好,Localization也好,whatever。最終要實現(xiàn)的效果呢,就是一鍵切換全站語言,并且開發(fā)的時候只需要寫一套頁面。
下面進(jìn)入正題
首先,我們要創(chuàng)建一個CultureConfigurer類,用于管理本地化資源,完成“翻譯”環(huán)節(jié):
這里我用了靜態(tài)類,然后在MVC項目StartUp的時候執(zhí)行Init()方法,其實有點蠢,當(dāng)然你們也可以先寫一個接口然后用依賴注入成單例。
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用于代表要實現(xiàn)的語言,這里我只是簡單的實現(xiàn)了中文和英文(其他我也不懂),對應(yīng)的CultureConfigurer類就有中文和英文兩個Dictionary
2. 使用了Assembly.Load加載了程序集,參數(shù)為你自己的程序集名稱,我這里就隨便寫了一個
3. 資源文件我選擇了json文件,也是為了方便js中調(diào)用,當(dāng)然你也可以用xml或者任何你想要用的格式,只需要調(diào)整解析方法,把文件內(nèi)容加載到對應(yīng)的Dictionary中就可以了
4. 看到GetValue方法,相信大家都已經(jīng)明白了,其實就是多語言不管是什么語言,都用某個詞做key,然后調(diào)用這個方法“翻譯”成當(dāng)前語言的詞。比如以“Open”作為Key,那么中文Dictionary中就應(yīng)該有一個KeyValuePair是"Open":"打開",而相應(yīng)的英文中應(yīng)該有一個"Open":"Open",那么Culture為中文時,顯示就是“打開”,英文就是“Open”。
5. 資源文件可以創(chuàng)建在程序集中的任何位置,如果你的項目有project.json文件,那么就在buildOptions里面添加,注意根據(jù)自己的文件位置修改路徑
"embed": {
"include": [
"Localization/SourceFiles/*.json"
]
}
如果是VS2017,是csproj文件,那么右擊要添加的資源文件,選擇“屬性”,配置改為“所有配置”,配置屬性的高級中“生成操作”修改為“嵌入的資源”,如下圖:

到這里,我們已經(jīng)寫好了實現(xiàn)本地化的核心類,下面要解決如何在頁面上顯示的問題:
在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里就可以直接調(diào)用啦。這里我寫了一個L方法,調(diào)用了CultureConfigurer的GetValue方法。那么,在頁面上需要翻譯的文字就只要寫成@L("Open")這樣的就可以啦。
可以看到,我是將用戶語言保存在Cookie中的,這里大家可以有各自的實現(xiàn)方法。我的實現(xiàn)方法很簡單,用戶切換語言的時候就訪問一個接口,修改了代表語言的Cookie,然后刷新頁面就可以了。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
ASP.NET:一段比較經(jīng)典的多線程學(xué)習(xí)代碼
ASP.NET:一段比較經(jīng)典的多線程學(xué)習(xí)代碼...2006-09-09
如何對ASP.NET網(wǎng)站實現(xiàn)靜態(tài)化
對于訪問量比較大的網(wǎng)站,網(wǎng)頁靜態(tài)化是一個比較可靠的解決方案。靜態(tài)化將顯著降低服務(wù)器的壓力,提升服務(wù)器處理能力。下面將介紹兩種不同的實現(xiàn)方法,并進(jìn)行對比。2015-09-09
asp.net基于Calendar實現(xiàn)blog日歷功能示例
這篇文章主要介紹了asp.net基于Calendar實現(xiàn)blog日歷功能,涉及asp.net使用Calendar控件操作日期與時間相關(guān)運(yùn)算技巧,需要的朋友可以參考下2017-07-07
一個Asp.Net的顯示分頁方法 附加實體轉(zhuǎn)換和存儲過程 帶源碼下載
現(xiàn)在自己寫的webform都不用服務(wù)器控件了,所以自己仿照aspnetpager寫了一個精簡實用的返回分頁顯示的html方法,其他話不說了,直接上代碼2012-10-10

