ASP.NET 国际化库 i18n 使用教程

ASP.NET 国际化库 i18n 使用教程

1. 项目介绍

i18n 是一个为 ASP.NET 应用程序提供国际化支持的库。它旨在替代传统的 .NET 资源文件，采用更为简单、全球公认的标准来实现 ASP.NET 网站和应用程序的本地化。i18n 支持多种 ASP.NET 技术，包括 ASP.NET MVC、Web API、WebMatrix / Web Pages 以及 Web Forms。

2. 项目快速启动

首先，您需要在项目中安装 i18n 包。可以通过NuGet包管理器进行安装：

PM> Install-Package i18N

接下来，在您的 web.config 文件中配置 i18n：

<system.web>
  <httpModules>
    <add name="i18n.LocalizingModule" type="i18n.LocalizingModule, i18n"/>
  </httpModules>
</system.web>
<system.webServer>
  <modules>
    <add name="i18n.LocalizingModule" type="i18n.LocalizingModule, i18n"/>
  </modules>
</system.webServer>
<appSettings>
  <add key="i18n.DirectoriesToScan" value=".."/>
  <add key="i18n.WhiteList" value="*.cs;*.cshtml;*.sitemap"/>
  <add key="i18n.BlackList" value=".\js\kendo;.\js\angular;.\*\dist"/>
</appSettings>

在 Application_Start 方法中，您可以设置默认语言和cookie名称等：

protected void Application_Start()
{
    i18n.LocalizedApplication.Current.DefaultLanguage = "zh";
    i18n.LocalizedApplication.Current.CookieName = "i18n_langtag";
}

最后，在您的视图或代码中，使用 [[[ 和 ]]] 标记需要本地化的字符串：

<div id="content">
  <h2>[[[欢迎来到我的应用程序！]]]</h2>
</div>

public ActionResult Index()
{
    ViewBag.Message = "[[[欢迎来到ASP.NET MVC！]]]";
    return View();
}

3. 应用案例和最佳实践

• 本地化HTML和Razor视图：使用 [[[ 标记需要本地化的文本，确保所有用户界面元素都被适当地本地化。
• 本地化C#代码：在代码中使用 [[[ 标记字符串，以便在不同的语言环境中正确显示。
• SEO优化：通过URL本地化，改变URL以包含语言标签，并适当设置 Content-Language 响应头。
• 性能优化：i18n 经过优化，以最小化性能开销和内存分配。

4. 典型生态项目

i18n 是一个开源项目，它与其他开源项目一起构成了一个生态系统，以下是一些典型的生态项目：

• GetText：一个用于文本国际化的工具，i18n 使用 GetText 生态系统进行本地化。
• PO文件编辑器：如 POEdit，用于编辑和翻译 PO 文件。
• 其他ASP.NET库：如 ASP.NET MVC、Web API 等框架，它们与 i18n 库无缝集成，提供全面的国际化支持。

通过上述教程，您可以开始使用 i18n 库为您的 ASP.NET 应用程序添加国际化功能。