ASP.NET Core 局部化实战教程

宗嫣惠

于 2024-08-16 08:36:16 发布

阅读量607

点赞数 25

本文链接：https://blog.csdn.net/gitblog_00470/article/details/141242071

版权

ASP.NET Core 局部化实战教程

AspNetCoreLocalizationLocalization.SqlLocalizer & ASP.NET Core MVC Localization Examples项目地址:https://gitcode.com/gh_mirrors/as/AspNetCoreLocalization

项目介绍

本教程基于GitHub开源项目 damienbod/AspNetCoreLocalization，该项目展示了如何在ASP.NET Core应用程序中实现多语言支持。通过利用IHtmlLocalizer和IStringLocalizer接口，开发者能够轻松地将文本资源外部化并实现本地化，以便根据不同用户的地域设置展示相应的语言版本。项目集成了.resx文件来存储翻译字符串，并通过中间件配置请求处理管道以实现全球化和局部化。

项目快速启动

环境准备

确保你的开发环境已安装了最新的.NET SDK，并且熟悉Visual Studio或Visual Studio Code等IDE。

步骤一：克隆项目

首先，从GitHub克隆此项目到本地：

git clone https://github.com/damienbod/AspNetCoreLocalization.git

步骤二：运行应用

使用Visual Studio或者dotnet CLI打开解决方案。
在解决方案中找到主项目（通常是名为“AspNetCoreLocalization”的Web应用项目）。
打开Startup.cs文件，检查ConfigureServices和Configure方法中的国际化配置是否正确。
运行应用 (Ctrl + F5)。

配置多语言环境

在项目的appsettings.json中，你可以配置默认语言和可用的其他语言。在浏览器中通过URL参数如?culture=fr来切换语言。

示例代码添加文化支持：

services.AddLocalization(options => options.ResourcesPath = "Resources");

以及在Configure方法中添加以下中间件：

app.UseRequestLocalization();

应用案例和最佳实践

动态切换语言

在控制器中注入IViewLocalizer，你可以在视图中动态显示不同语言的内容。

BookController 示例

public class BookController : Controller
{
    private readonly IHtmlLocalizer<BookController> _localizer;

    public BookController(IHtmlLocalizer<BookController> localizer)
    {
        _localizer = localizer;
    }

    public IActionResult Index()
    {
        ViewData["Message"] = _localizer["Welcome to localized ASP.NET Core web app."];
        return View();
    }
}

在视图中使用局部化字符串：

<h2>@ViewData["Message"]</h2>

资源文件管理

确保你的.resx文件位于指定的路径下(Resources)，并且为每种语言创建对应的文件，例如SharedResources.en.resx, SharedResources.fr.resx等。

典型生态项目

在ASP.NET Core的生态系统中，除了直接使用官方提供的本地化功能，还有许多社区维护的扩展可以增强国际化的体验，比如Microsoft.AspNetCore.RequestLocalizationMiddleware、各种本地化工具包，以及用于更复杂需求的第三方库。这些生态项目的集成可以进一步提升应用程序的国际化能力，满足特定场景下的需求。

在进行项目开发时，推荐研究这些生态项目，以便选择最适合你的项目需求的方案。对于复杂的本地化需求，理解如何自定义资源加载逻辑和适应性策略是非常重要的。

这个教程提供了一个基础的框架，帮助您开始在ASP.NET Core项目中实施本地化。实践是掌握这些概念的关键，所以动手尝试并在您的项目中应用这些知识吧！

AspNetCoreLocalizationLocalization.SqlLocalizer & ASP.NET Core MVC Localization Examples项目地址:https://gitcode.com/gh_mirrors/as/AspNetCoreLocalization