ASP.NET Core 应用程序国际化（Localization）教程

ASP.NET Core 应用程序国际化（Localization）教程

Localization [Archived] Localization abstractions and implementations for ASP.NET Core applications. Project moved to https://github.com/aspnet/AspNetCore 项目地址: https://gitcode.com/gh_mirrors/loca/Localization

项目介绍

[ASP.NET Core Localization] 是一个已归档的项目，提供了一套抽象层及实现方案，用于在ASP.NET Core应用程序中实现多语言支持。虽然此仓库已被标记为归档状态，但相关的开发工作已经迁移至 ASP.NET Core 主仓库中继续进行。该框架允许开发者轻松地将应用界面本地化，以适应全球化的用户需求。

项目快速启动

要快速开始使用ASP.NET Core中的国际化功能，请首先确保你的项目是基于ASP.NET Core且已更新到最新版本。接下来的步骤概括了基本设置：

步骤1: 添加依赖项

在你的.csproj文件中添加Microsoft.AspNetCore.Localization包的引用（注意，实际操作时应查找最新的稳定版本）:

<ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Localization" Version="对应的版本号" />
</ItemGroup>

步骤2: 配置请求 culture

在Startup.cs的ConfigureServices方法内添加以下服务配置：

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

并配置中间件来处理文化的更改，这通常发生在Configure方法中：

app.UseRequestLocalization();

步骤3: 创建资源文件

在项目中创建一个名为Resources的文件夹，并在此处添加如SharedResources.de.resx (德语) 和 SharedResources.en-US.resx (美式英语) 的资源文件，用于存放翻译文本。

步骤4: 在视图中使用资源

在Razor视图中，通过@inject指令注入IViewLocalizer服务，并使用它来获取本地化字符串：

@using Microsoft.AspNetCore.Mvc.Localization
@inject IViewLocalizer Localizer

<h1>@Localizer["WelcomeMessage"]</h1>

步骤5: 提供切换文化的接口

你可以通过导航菜单或其他方式提供一个让用户选择语言的选项，然后利用路由参数或者查询字符串来改变当前文化上下文。

应用案例和最佳实践

• 动态切换文化：在用户界面提供语言切换按钮，结合URL参数或者Cookie存储用户的语言偏好。
• 资源文件命名规范：保持资源文件命名一致，便于管理和扩展。
• 性能考虑：缓存频繁访问的本地化字符串，减少每次请求的计算成本。
• 默认文化：明确设定应用的默认文化，以防用户端未指定时依然能够正常显示内容。

典型生态项目

由于原项目已迁移到ASP.NET Core主仓库，关注相关特性的生态系统应指向ASP.NET Core官方文档和社区贡献的示例。例如，深入学习可以参考ASP.NET Core官方文档中的国际化和全球化部分，这里提供了更详尽的最佳实践和高级用法。

---

以上步骤提供了一个基础框架，让你能够快速地在ASP.NET Core项目中集成国际化功能。随着你深入学习和实践，你会找到更多优化和定制化的解决方案。记得始终关注ASP.NET Core的官方更新，以便获取最新的功能和支持。

Localization [Archived] Localization abstractions and implementations for ASP.NET Core applications. Project moved to https://github.com/aspnet/AspNetCore 项目地址: https://gitcode.com/gh_mirrors/loca/Localization