如何通过数据注解本地化ASP.NET Core子类的继承属性？

我之前也碰到过类似的困扰，核心是ASP.NET Core的本地化资源查找逻辑默认不会自动遍历父类的资源文件，不管是Identity自带的基类还是你自定义的父类，都需要明确指定资源位置或者遵循特定的命名规范。下面分场景给你拆解解决方案：

一、针对IdentityUser继承类的Email属性本地化 #

如果你不想重写IdentityUser的Email属性，有两个高效的方案：

1. 使用全局共享资源文件 #

创建一个通用的共享资源文件（比如SharedResources.resx，对应的本地化文件如SharedResources.zh-CN.resx），然后在程序启动时配置所有数据注解都使用这个共享资源：

// Program.cs
builder.Services.AddLocalization(options => options.ResourcesPath = "Resources");

builder.Services.AddIdentity<User, IdentityRole>()
    .AddEntityFrameworkStores<ApplicationDbContext>()
    .AddDefaultTokenProviders()
    .AddDataAnnotationsLocalization(options =>
    {
        // 指定所有数据注解的本地化使用SharedResources
        options.DataAnnotationLocalizerProvider = (type, factory) =>
            factory.Create(typeof(SharedResources));
    });

之后只需要在SharedResources.xx.resx里添加键Email，设置对应的本地化值即可，比如中文环境下值为“邮箱”。

2. 为IdentityUser单独创建资源文件 #

IdentityUser位于Microsoft.AspNetCore.Identity命名空间下，你需要严格按照命名空间+类名的规则创建资源文件：

• 创建文件Microsoft.AspNetCore.Identity.IdentityUser.xx.resx（比如Microsoft.AspNetCore.Identity.IdentityUser.zh-CN.resx）
• 将资源文件的生成操作设置为「嵌入的资源」（右键文件→属性→生成操作）
• 在资源文件中添加键Email并设置本地化值

框架会自动匹配到IdentityUser类的资源，不用修改任何代码。

二、自定义父类子类的属性本地化（比如UserInputModel） #

对于你自定义的UserInputModel : UserInputModelParrent，同样需要遵循资源查找规则：

1. 给父类单独创建资源文件 #

• 创建MyProj.ViewModels.UserInputModelParrent.xx.resx（对应父类的完整命名空间+类名）
• 确保资源文件的生成操作是「嵌入的资源」，并且自定义工具命名空间设置为MyProj.ViewModels（右键文件→属性→自定义工具命名空间）
• 在资源文件中添加键Email并设置本地化值

这样框架会在渲染子类的Email属性时，自动找到父类的资源文件。

2. 强制指定资源类型（可选） #

如果不想依赖命名规范，也可以在子类中通过元数据扩展指定父类的资源（不用重写属性）：

using System.ComponentModel.DataAnnotations;
using System.ComponentModel;

[MetadataType(typeof(UserInputModelMetadata))]
public class UserInputModel : UserInputModelParrent { }

public class UserInputModelMetadata
{
    [Display(Name = nameof(UserInputModelParrent.Email), ResourceType = typeof(UserInputModelParrentResources))]
    public string Email { get; set; }
}

这里的UserInputModelParrentResources是父类资源文件自动生成的类（需要确保资源文件的自定义工具是ResXFileCodeGenerator）。

三、关键检查点 #

无论哪种方案，都要确保以下几点：

• 资源文件放在你配置的ResourcesPath目录下（比如Program.cs里设置的options.ResourcesPath = "Resources"）
• 资源文件的生成操作必须是「嵌入的资源」
• 本地化中间件配置正确，比如：

  var supportedCultures = new[] { "en", "zh-CN" };
  var localizationOptions = new RequestLocalizationOptions()
      .SetDefaultCulture(supportedCultures[0])
      .AddSupportedCultures(supportedCultures)
      .AddSupportedUICultures(supportedCultures);
  
  app.UseRequestLocalization(localizationOptions);
  

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