C#中如何使用EF Core的关系配置?如何定义外键?

来源:这里教程网 时间:2026-02-21 17:26:34 作者:

在C#中使用EF Core配置实体之间的关系,核心是通过 Fluent API数据注解(Data Annotations) 来定义外键和导航属性。下面介绍常见的一对多、一对一、多对多关系的配置方式以及外键的定义。

1. 定义外键与一对多关系

这是最常见的场景,比如一个“用户”可以有多个“订单”。

示例模型:
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public ICollection<Order> Orders { get; set; }
}
public class Order
{
    public int Id { get; set; }
    public int UserId { get; set; }  // 外键
    public User User { get; set; }   // 导航属性
}
使用 Fluent API 配置(在 DbContext 中):
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Order>()
        .HasOne(o => o.User)           // Order 拥有一个 User
        .WithMany(u => u.Orders)       // User 有多个 Order
        .HasForeignKey(o => o.UserId); // 外键是 Order 的 UserId
}
或使用数据注解:
public class Order
{
    public int Id { get; set; }
    [ForeignKey("User")]
    public int UserId { get; set; }
    public User User { get; set; }
}

2. 一对一关系配置

例如,一个“用户”对应一个“用户资料”。

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public Profile Profile { get; set; }
}
public class Profile
{
    public int Id { get; set; }
    public int UserId { get; set; }
    public string Bio { get; set; }
    public User User { get; set; }
}
Fluent API 配置:
modelBuilder.Entity<User>()
    .HasOne(u => u.Profile)
    .WithOne(p => p.User)
    .HasForeignKey<Profile>(p => p.UserId);

注意:一对一中,外键通常放在“依赖实体”上(这里是 Profile)。

3. 多对多关系配置(EF Core 5+ 支持自动生成中间表)

例如,“学生”和“课程”是多对多关系。

public class Student
{
    public int Id { get; set; }
    public string Name { get; set; }
    public ICollection<Course> Courses { get; set; }
}
public class Course
{
    public int Id { get; set; }
    public string Title { get; set; }
    public ICollection<Student> Students { get; set; }
}
Fluent API 配置(EF Core 会自动创建中间表):
modelBuilder.Entity<Student>()
    .HasMany(s => s.Courses)
    .WithMany(c => c.Students);

EF Core 会生成名为

StudentCourses
的中间表,包含
StudentsId
CoursesId
两个外键。

如需自定义中间表:

可以显式定义中间实体,并配置两个一对多关系。

4. 外键的可空性与级联删除

控制外键是否允许为空,以及删除行为:

modelBuilder.Entity<Order>()
    .HasOne(o => o.User)
    .WithMany(u => u.Orders)
    .HasForeignKey(o => o.UserId)
    .OnDelete(DeleteBehavior.Cascade); // 删除用户时,其订单也被删除

如果外键是可空的(int?),则表示关系是可选的:

public int? UserId { get; set; } // 可选关系

基本上就这些。根据实际业务选择合适的关系类型,优先使用 Fluent API 获得更灵活的控制。

相关推荐