asp.net

ModelBuilder.Entity

2025-08-24

ModelBuilder.Entity 是 Entity Framework (EF)中用于定义实体与数据库之间映射关系的核心API。通过 Fluent API (即 DbModelBuilder 相关方法),开发者可以在 OnModelCreating 方法中配置实体关系、属性映射等数据库模型细节。 ‌


核心功能

1、‌实体关系配置‌:支持一对一、一对多、多对多等关系定义,例如通过:ml-search[HasOne]、:ml-search[HasMany]等API设置实体间的关联。 ‌


2、‌属性映射‌:可配置属性映射规则,例如将自定义类型(如Currency)转换为数据库支持的数值类型。 ‌


‌3、表结构定制‌:支持自定义表名、键名等数据库结构参数。 ‌


典型应用场景

‌1、一对一关系‌:例如学生与桌位信息的关系,需在Student类中定义DeskID字段,并通过:ml-search[HasForeignKey]配置外键关联。 ‌


2、‌一对多关系‌:如博客与评论的关系,通过:ml-search[HasMany]配置子表关联。 ‌


‌3、多对多关系‌:通过:ml-search[MapLeftKey]、:ml-search[MapRightKey]等API实现复杂

注意事项

1、配置需在:ml-search[DbContext]的:ml-search[OnModelCreating]方法中完成,避免重复配置。 ‌


2、不同版本的EF Core(如6.x、9.x)API可能存在差异,需参考对应版本文档。 ‌