Asp.net Core如何在静态扩展方法中实现本地化？

针对静态扩展方法无法直接依赖注入IStringLocalizer<SharedResource>的问题，这里提供三种实用方案：

方案一：通过服务定位器初始化静态本地化器 #

这种方法可以保持扩展方法的调用方式不变，核心是在应用启动时将本地化器实例注入到静态类的静态字段中。

步骤1：修改静态扩展类 #

添加静态字段和初始化方法：

public static class StringExtensions
{
    private static IStringLocalizer<SharedResource> _localizer;

    // 供应用启动时初始化本地化器
    public static void Initialize(IStringLocalizer<SharedResource> localizer)
    {
        _localizer = localizer ?? throw new ArgumentNullException(nameof(localizer));
    }

    public static string? IsValidPriority(this string? priority)
    {    
        if (!string.IsNullOrEmpty(priority) && new[] { "HIGH", "MEDIUM", "NORMAL", "LOW" }.Contains(priority))
        {
            return priority;
        }

        // 使用本地化后的错误信息
        throw new CustomValidationException(_localizer["Invalid priority"]);
    }
}

步骤2：在Program.cs中初始化 #

在应用构建完成后，从服务容器中获取本地化器并初始化静态类：

var builder = WebApplication.CreateBuilder(args);

// 保留你已有的本地化配置
builder.Services.AddLocalization(options => options.ResourcesPath = "Resources");
builder.Services.AddControllersWithViews()
    .AddViewLocalization()
    .AddDataAnnotationsLocalization(options =>
    {
        options.DataAnnotationLocalizerProvider = (type, factory) => factory.Create<SharedResource>();
    });

var app = builder.Build();

// 初始化静态扩展类的本地化器
using (var scope = app.Services.CreateScope())
{
    var localizer = scope.ServiceProvider.GetRequiredService<IStringLocalizer<SharedResource>>();
    StringExtensions.Initialize(localizer);
}

// 其他中间件配置...
app.Run();

优缺点：

• 优点：无需修改现有扩展方法的调用代码，兼容性好
• 缺点：引入静态依赖，单元测试时需手动初始化本地化器，不符合纯依赖注入原则

方案二：将本地化器作为参数传入扩展方法 #

这种方式更符合依赖注入的设计原则，需要在调用扩展方法时手动传入本地化器实例。

修改扩展方法 #

public static class StringExtensions
{
    public static string? IsValidPriority(this string? priority, IStringLocalizer<SharedResource> localizer)
    {    
        if (!string.IsNullOrEmpty(priority) && new[] { "HIGH", "MEDIUM", "NORMAL", "LOW" }.Contains(priority))
        {
            return priority;
        }

        throw new CustomValidationException(localizer["Invalid priority"]);
    }
}

在控制器中调用 #

public class TaskController : Controller
{
    private readonly IStringLocalizer<SharedResource> _localizer;

    public TaskController(IStringLocalizer<SharedResource> localizer)
    {
        _localizer = localizer;
    }

    public IActionResult Create(string priority)
    {
        // 调用扩展方法时传入本地化器
        priority.IsValidPriority(_localizer);
        // 后续业务逻辑...
        return Ok();
    }
}

优缺点：

• 优点：遵循DI原则，单元测试时可轻松mock本地化器
• 缺点：所有调用该扩展方法的地方都需要传入本地化器，代码改动较大

方案三：使用强类型静态资源类 #

如果你的本地化资源是基于ResX文件的，可以通过生成静态资源类来直接访问本地化字符串，无需依赖注入。

步骤1：配置ResX文件 #

确保你的SharedResource.resx（及对应语言的资源文件，如SharedResource.zh-CN.resx）的自定义工具设置为ResXFileCodeGenerator，自定义工具命名空间设置为你的项目命名空间。

步骤2：直接使用静态资源类 #

生成后可以直接通过静态类访问本地化字符串：

public static class StringExtensions
{
    public static string? IsValidPriority(this string? priority)
    {    
        if (!string.IsNullOrEmpty(priority) && new[] { "HIGH", "MEDIUM", "NORMAL", "LOW" }.Contains(priority))
        {
            return priority;
        }

        // 直接访问静态资源类的属性
        throw new CustomValidationException(SharedResource.InvalidPriority);
    }
}

注意：这种方式依赖当前线程的文化设置，确保你的应用已经正确配置了文化中间件：

app.UseRequestLocalization();

优缺点：

• 优点：代码最简洁，无需依赖注入或初始化逻辑
• 缺点：仅支持ResX资源文件，且依赖线程文化，动态切换文化时需确保线程文化同步更新

内容的提问来源于stack exchange，提问作者smilu