全球化与本地化

视频免费1:10:00超过 2 年前

全球化 (G11N)使应用支持不同语言和区域的过程。缩写来自第一个和最后一个字母以及它们之间的字母数，本地化 (L10N)针对特定语言和区域自定义全球化应用的过程，国际化 (I18N)包括全球化和本地化，区域性是一种语言或区域，非特定区域性，具有指定语言但不具有区域的区域性，特定区域性，具有指定语言但和区域的区域性。

.NET Platform

正在加载视频…

全球化与本地化

全球化是指 Web 应用程序能够适应不同的文化和地区，而不需要修改代码。本地化是指 Web 应用程序能够根据用户的文化和地区显示不同的内容。全球化和本地化是两个不同的概念，但是经常一起使用。

实现多语言的方法有很多种，可以使用资源文件、数据库、配置文件等方式，本文主要介绍使用资源文件的方式实现多语言，也是微软官方推荐的方式。其它的比如 PO 文件、JSON 文件等也可以实现多语言，但是不如资源文件方便.

创建资源文件

Welcome.en-US.resx
Welcome.zh-CN.resx

text

添加本地化服务和资源定位

public static IServiceCollection AddCustomLocalization(this IServiceCollection services)
{
    services.AddLocalization(options => options.ResourcesPath = "Resources");
 
    return services;
}

csharp

使用本地化服务

public class HelloWorldController(IStringLocalizerFactory stringLocalizerFactory) : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        var location = Assembly.GetExecutingAssembly().FullName;
 
        ArgumentException.ThrowIfNullOrWhiteSpace(location);
 
        var localizer = stringLocalizerFactory.Create("Welcome", location);
 
        return Ok(localizer["HelloWorld"].Value);
    }
}

csharp

使用 HTTP 请求设置语言

UseRequestLocalization 中间件从请求中获取语言设置，然后设置当前线程的语言，以便在后续的请求中使用，这样就可以实现全局的本地化，而不需要在每个控制器中设置本地化。

public static IApplicationBuilder UseCustomLocalization(this IApplicationBuilder app)
{
    var supportedCultures = new[] { "zh-CN", "en-US" };
 
    var localizationOptions = new RequestLocalizationOptions().SetDefaultCulture(supportedCultures.First())
        .AddSupportedCultures(supportedCultures)
        .AddSupportedUICultures(supportedCultures);
 
    app.UseRequestLocalization(localizationOptions);
 
    return app;
}

csharp

使用下面的方式从 Header 、 QueryString 或者 Cookie 中获取语言设置：

Accept-Language: en-US

text

http://localhost:5000/?culture=en-Us

text

.AspNetCore.Culture=en-US

text

OpenApi 设置 Accept-Language 以实现多语言

services.Configure<SwaggerGenOptions>(options => options.OperationFilter<AcceptLanguageHeaderOperationFilter>());

csharp

public class AcceptLanguageHeaderOperationFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        var parameter = new OpenApiParameter
        {
            Name = HeaderNames.AcceptLanguage,
            In = ParameterLocation.Header,
            Required = false,
            Schema = new OpenApiSchema
            {
                Default = new OpenApiString("zh-CN"),
                Type = "string",
                Enum = [new OpenApiString("zh-CN"), new OpenApiString("en-US")]
            }
        };
 
        operation.Parameters.Add(parameter);
    }
}

csharp

实现数据展示的全球化

 
public class HelloWorldController(IStringLocalizerFactory stringLocalizerFactory) : ControllerBase
{
    [HttpGet("time")]
    public IActionResult GetTime(
    {
        //string amount=88.88.ToString("C");
        return Ok(TimeProvider.System.GetUtcNow().ToString());
    }
}

csharp

实现模型和属性的本地化

    IStringLocalizerFactory localizerFactory = app.ApplicationServices.GetRequiredService<IStringLocalizerFactory>();
 
    ValidatorOptions.Global.DisplayNameResolver = (type, memberInfo, lambdaExpression) =>
    {
        string displayName = memberInfo.Name;
 
        DisplayAttribute? displayAttribute = memberInfo.GetCustomAttribute<DisplayAttribute>(true);
 
        displayName = displayAttribute?.Name ?? displayName;
 
        DisplayNameAttribute? displayNameAttribute = memberInfo.GetCustomAttribute<DisplayNameAttribute>(true);
 
        displayName = displayNameAttribute?.DisplayName ?? displayName;
 
        var localizer = localizerFactory.Create(type);
 
        return localizer[displayName];
    };

csharp

本地化验证错误消息

public UserCreateRequestValidator(IdentityServiceDbContext dbContext, IStringLocalizer<UserCreateRequest> localizer)
{
    RuleFor(m => m.PhoneNumber).NotNull().NotEmpty().Length(11).Matches(@"^1\d{10}$").Must((model, phoneNumber) =>
    {
        return !dbContext.Users.Any(e => e.PhoneNumber == phoneNumber);
    }).WithMessage(localizer["PhoneNumberExists"]);
}

csharp

微软 Resx 编辑工具

必应搜索 Resx Editor 关键字可以找到很多工具，可以编辑 Resx 文件。

https://learn.microsoft.com/zh-cn/dotnet/framework/tools

使用必应翻译资源文件

必应搜索 Resx Translation 关键字可以找到很多翻译工具，可以将英文资源文件翻译成其他语言。

自动翻译工具

https://github.com/salarcode/AutoResxTranslator

https://github.com/stevencohn/ResxTranslator

https://github.com/HakanL/resxtranslator

https://apps.microsoft.com/detail/9mtpd7jzxnnn

接着看

视频零度新版框架搭建系列视频教程订阅

构建可靠的事务性发件箱模式

事务性发件箱模式确保将事件保存在数据存储中，然后再最终推送到消息代理。如果业务对象和相应的事件保存在同一数据库事务中，则保证不会丢失任何数据。所有内容都将被提交，或在出错时所有内容回滚。为了最终发布事件，其他服务或工作进程会在发件箱表中查询未处理项，发布这些事件，并将其标记为已处理。此模式可确保创建或修改业务对象后不会丢失事件。

1:01:15超过 1 年前

视频零度新版框架搭建系列视频教程订阅

EF Core中数据库迁移与初始化的核心概念与实用技巧。内容包括生成与应用迁移脚本、EnsureCreatedAsync与MigrateAsync的使用及冲突解决、通过内部服务实现优雅的自动迁移、EF Core 9.0推荐的异步种子数据初始化方法，以及利用IHostedService或BackgroundService实现耗时操作的异步数据库初始化。通过本课程，开发者将掌握高效管理数据库生命周期的最佳实践，提升项目开发效率与质量。

57:00超过 1 年前

视频零度新版框架搭建系列视频教程订阅