如何在Entity Framework Core中使用资源开发.NET Core 5多语言应用
.NET Core 5 多语言应用落地实现指南
已完成ViewModel资源配置、使用DisplayName特性的场景补全
你目前已经完成的ViewModel资源绑定、DisplayName特性标注的操作,是多语言实现的核心基础,只需要补全以下几处配置就能跑通完整链路:
- 在
Startup.cs的ConfigureServices方法中注册本地化相关服务,确保ViewModel的数据注解能自动读取绑定的资源值:// 注册资源定位服务,指定资源文件根目录为项目下的Resources文件夹 services.AddLocalization(options => options.ResourcesPath = "Resources"); services.AddMvc(options => { options.EnableEndpointRouting = false; }) // 支持视图层的本地化读取 .AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix) // 关键:让DataAnnotations(包括你用的DisplayName特性)自动关联对应资源 .AddDataAnnotationsLocalization(); - 在
Startup.cs的Configure方法中配置本地化请求中间件,指定系统支持的语言列表、默认语言:// 配置系统支持的语言列表 var supportedCultures = new[] { new CultureInfo("zh-CN"), new CultureInfo("en-US") }; // 中间件必须放在UseRouting、UseEndpoints之前,否则不生效 app.UseRequestLocalization(new RequestLocalizationOptions { DefaultRequestCulture = new RequestCulture("zh-CN"), SupportedCultures = supportedCultures, SupportedUICultures = supportedCultures }); - 配置自定义语言切换逻辑:本地化中间件会自动从Cookie、URL查询参数、请求头中识别当前用户的语言偏好,你只需要在切换语言的接口里把用户选择的语言值写入指定Cookie即可,无需手动写文化判断逻辑。Cookie的默认键为
.AspNetCore.Culture,值的格式为c=对应语言码|uic=对应语言码,比如c=en-US|uic=en-US,中间件可自动识别。 - 资源文件匹配规则对齐:你绑定到ViewModel的资源文件,命名必须和ViewModel的完整命名空间对应,比如ViewModel位于
YourProject.Models.ViewModels.UserViewModel,对应的资源文件需要放在Resources目录下,命名为YourProject.Models.ViewModels.UserViewModel.zh-CN.resx、YourProject.Models.ViewModels.UserViewModel.en-US.resx,否则DisplayName特性会读取不到资源值。
Entity Framework Core 多语言支持实现
EF Core的多语言支持主要分两类落地场景,可根据业务需求选择:
- 实体属性类多语言(比如商品名称、文章标题这类需要按语言存不同业务值的场景)
不建议在主实体中冗余存储所有语言的字段,避免实体臃肿,采用独立语言关联表的方案:- 主实体仅存储和语言无关的通用属性,比如商品Id、价格、创建时间,同时添加关联语言表的导航属性:
public class Product { public int Id { get; set; } public decimal Price { get; set; } // 关联的不同语言版本数据 public ICollection<ProductLanguage> LanguageVersions { get; set; } = new List<ProductLanguage>(); } - 新建语言版本子表实体,存储和语言绑定的业务字段,通过外键关联主实体Id:
public class ProductLanguage { public int Id { get; set; } // 关联的主实体Id public int ProductId { get; set; } // 业务字段 public string ProductName { get; set; } public string ProductDesc { get; set; } // 对应语言码,比如zh-CN、en-US public string CultureCode { get; set; } public Product Product { get; set; } } - 在DbContext中配置全局查询过滤器,根据当前请求的语言码自动过滤匹配的语言版本数据,无需每次查询手动加Where条件:
protected override void OnModelCreating(ModelBuilder modelBuilder) { // 获取当前线程的UI文化码 var currentCulture = CultureInfo.CurrentUICulture.Name; // 给语言表配置全局过滤规则 modelBuilder.Entity<ProductLanguage>() .HasQueryFilter(pl => pl.CultureCode == currentCulture); } - 给语言表建立
(ProductId, CultureCode)的组合唯一索引,避免同一语言下同一业务实体出现重复数据。
- 主实体仅存储和语言无关的通用属性,比如商品Id、价格、创建时间,同时添加关联语言表的导航属性:
- 动态配置类多语言(比如菜单文字、系统提示语这类存在数据库中、无需每次改资源文件发版的场景)
可以实现自定义的IStringLocalizer接口,从数据库的多语言字符串表中读取对应语言的配置值,替换默认从resx资源文件读取的逻辑。这种方式和你之前在ViewModel上用DisplayName特性、视图层本地化的逻辑完全兼容,业务代码不需要做任何改造。
实操注意事项
- 跨异步流程、后台任务场景下,不要直接依赖
CultureInfo.CurrentUICulture获取当前语言,避免出现因为线程切换导致的文化值丢失问题,需要手动将语言值传入方法内或者通过异步本地存储同步。 - 项目中的resx资源文件访问修饰符需要设置为
Public,否则运行时会抛出资源找不到的异常。 - 中间件的注册顺序不能颠倒,本地化中间件必须放在路由、端点映射的配置之前。
内容的提问来源于stack exchange,提问作者Mahboobeh Mohseni
相关产品推荐
相关产品推荐

