EF Core如何在IEntityTypeConfiguration为集合添加Where筛选？

你想要在IEntityTypeConfiguration中给实体集合添加筛选条件，让Form.Items仅包含与当前Form的FormId匹配且ParentFormItemId为null的FormItem实体，现有实体类及配置代码如下：

public class Form
{
    public Guid FormId { get; set; }
    public List<FormItem> Items { get; set; }
}

public class FormItem
{
    public Guid FormItemId { get; set; }
    public Guid FormId { get; set; }
    public virtual Form Form { get; set; }
    public Guid? ParentFormItemId { get; set; }
    public List<FormItem> Children { get; set; }
}

public class FormConfiguration : IEntityTypeConfiguration<Form>
{
    public void Configure(EntityTypeBuilder<Form> builder)
    {
        builder.HasKey(u => u.FormId);

        builder
            .HasMany(x => x.Items)
            .WithOne(c => c.Form);
    }
}

期望实现类似如下的配置效果，使Form.Items仅关联该表单的父级FormItem，而非全部关联项：

builder
    .HasMany(x => x.Items)
    .WithOne(c => c.Form)
    .Where(x => x.ParentFormItemId == null);

可以实现，不过EF Core中无法直接在HasMany/WithOne链式调用后添加.Where，但有两种常用方案达成需求：

1. 用HasFilter配置全局关联筛选 #

在FormItem的实体配置类中，给关联关系添加全局筛选条件：

public class FormItemConfiguration : IEntityTypeConfiguration<FormItem>
{
    public void Configure(EntityTypeBuilder<FormItem> builder)
    {
        builder.HasKey(f => f.FormItemId);
        // 为Form与FormItem的关联设置筛选，只加载ParentFormItemId为null的记录
        builder.HasOne(fi => fi.Form)
               .WithMany(f => f.Items)
               .HasForeignKey(fi => fi.FormId)
               .HasFilter("ParentFormItemId IS NULL");
    }
}

这里HasFilter需要传入SQL表达式字符串（暂不支持LINQ表达式），配置后从Form.Items加载的永远是符合条件的FormItem，同时EF会自动匹配对应的FormId关联。

2. 在实体类中用只读属性封装筛选集合 #

如果不需要全局生效，或者想要更灵活的LINQ筛选逻辑，可以在Form类中定义只读属性来返回筛选后的集合：

public class Form
{
    public Guid FormId { get; set; }
    // 私有字段用于EF映射，避免外部直接修改
    private List<FormItem> _items { get; set; }
    // 对外暴露已筛选的父级FormItem集合
    public IEnumerable<FormItem> Items => _items?.Where(x => x.ParentFormItemId == null) ?? Enumerable.Empty<FormItem>();
}

然后在FormConfiguration中映射私有字段：

public class FormConfiguration : IEntityTypeConfiguration<Form>
{
    public void Configure(EntityTypeBuilder<Form> builder)
    {
        builder.HasKey(u => u.FormId);
        // 关联映射到私有字段_items
        builder.HasMany(x => x.Items)
               .WithOne(c => c.Form)
               .HasForeignKey(c => c.FormId)
               .UsingEntity(e => e.Metadata.SetField("_items"));
    }
}

这种方式支持LINQ表达式筛选，逻辑调整更灵活，但要注意：如果启用了延迟加载，访问Items时会先查询所有关联的FormItem再在内存中筛选。

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