c# - Include() 方法在 Entity Framework 中的作用是什么

我有两个实体 Permission 和 Access

Access.cs

public class Access
{
    public int Id { get; set; }

    public string Name { get; set; }

    public List<Permission> PermissionList { get; set; }
}

Permission.cs

public class Permission
{
    public int Id { get; set; }

    public string Name { get; set; }

    public int ParentId { get; set; }

    [NotMapped]
    public bool HasChildren { get; set; }

    [NotMapped]
    public List<Permission> ChildPermissions { get; set; }
}

我还有 GenericRepository 类来过滤我的数据库中的记录。

GenericRepository.cs

 public virtual IEnumerable<TEntity> Get(
            Expression<Func<TEntity, bool>> filter = null,
            Func<IQueryable<TEntity>, IOrderedQueryable<TEntity>> orderBy = null,
            string includeProperties = "", bool tracking = true)
        {
            IQueryable<TEntity> query = dbSet;


            if (filter != null)
            {
                query = query.Where(filter);
            }

            foreach (var includeProperty in includeProperties.Split
                (new char[] { ',' }, StringSplitOptions.RemoveEmptyEntries))
            {
                query = query.Include(includeProperty);
            }
        /*...*/
        }

我在 Access Service 类中调用此方法

AccessService.cs

GenericRepository<Access> accessRepo = new GenericRepository<Access>();
List<Access> accessList = accessRepo.Get(d => d.Name == accessName, null, "PermissionList").OrderBy(d => d.Id).ToList();

此代码过滤“访问”类型的记录，然后在通用存储库中使用包含“PermissionList”参数的 Include() 方法。 Include("PermissionList") 方法的作用是什么？
它有什么作用？ PermissionList 是 Access 的一个属性，具有 Permission 的元素类型。但我不能完全明白它的目的是什么。

最佳答案

它用于急切地加载相关实体。

见 Entity Framework Loading Related Entities 。

不使用 Include() 时，此查询:

using (var context = new YourContext())
{
    var access = context.Access.Single(a => a.ID == 42);
}

将返回一个带有空 Access 属性的 PermissionList 实例。根据上下文的配置方式，此集合将保持为空(无延迟加载)或在您访问它时立即延迟加载( foreach (var permission in access.PermissionList) { ... } )。

现在使用 Include() :

using (var context = new YourContext())
{
    var access = context.Access.Include(a => a.PermissionList)
                               .Single(a => a.ID == 42);
}

查询将被编写为连接，为您加载所有相关权限。
Include() 扩展方法还有一个字符串重载，您的存储库代码正在调用它:

query = query.Include(includeProperty);

这会导致在您的情况下 "PermissionList" 急切加载，并且它似乎支持使用逗号分隔列表(例如 Include() )的多个 "PermissionList,PermissionList.ChildPermissions" 。