C#中如何使用EF Core的复杂类型？如何定义？

来源：这里教程网时间：2026-02-21 17:28:15 作者：

在C#中使用EF Core的复杂类型（Owned Types）是一种将值对象建模为实体一部分的有效方式。它允许你将一个类作为另一个实体的组成部分，而不需要独立的数据库表。

什么是复杂类型（Owned Type）？

复杂类型是EF Core中用于表示“拥有”关系的一种机制。它通常用于表示没有独立标识（即无主键）的值对象。例如，一个

Address

类可以作为

Order

或

Person

的一部分存在，不单独存在表中。

如何定义复杂类型？

要定义一个复杂类型，首先创建一个普通的C#类，然后通过配置告诉EF Core该类是“被拥有的”。

示例：定义Address类作为复杂类型

public class Address
{
    public string Street { get; set; }
    public string City { get; set; }
    public string PostalCode { get; set; }
    public string Country { get; set; }
}

public class Order
{
    public int Id { get; set; }
    public string OrderNumber { get; set; }
    // 这个属性将被映射为复杂类型
    public Address ShippingAddress { get; set; }
}

如何在DbContext中配置复杂类型？

使用

OnModelCreating

方法中的

OwnsOne

来配置复杂类型。

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Order>()
        .OwnsOne(o => o.ShippingAddress, sa =>
        {
            sa.Property(a => a.Street).HasColumnName("Shipping_Street");
            sa.Property(a => a.City).HasColumnName("Shipping_City");
            sa.Property(a => a.PostalCode).HasColumnName("Shipping_PostalCode");
            sa.Property(a => a.Country).HasColumnName("Shipping_Country");
        });
}

说明：

OwnsOne
表示该实体拥有一个复杂类型的实例。 你可以自定义列名和约束，避免字段名冲突（如多个地址）。 默认情况下，EF Core会将所有属性展平到主表中，不会创建新表。

支持集合类型的复杂类型（OwnsMany）

如果你需要一个实体拥有多个复杂类型实例（例如订单有多个收货地址），可以使用

OwnsMany

。

public class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    public List<Address> Addresses { get; set; } = new List<Address>();
}

modelBuilder.Entity<Customer>()
    .OwnsMany(c => c.Addresses, a =>
    {
        a.Property(addr => addr.Street).HasColumnName("Street");
        a.Property(addr => addr.City).HasColumnName("City");
        // 注意：OwnsMany会在单独的表中存储这些数据
    });

注意：