Entity Framework Core中如何加载实体的单个导航属性？

假设已有一个包含子实体Child的Foo实体实例，该Foo实例的ChildId已设置，但Child未加载，即foo.ChildId == 1234但foo.Child == null。想在Child缺失时获取它，已知可以通过重新查询Include的方式实现，但希望有更简便的显式加载指定属性的写法。

EF Core 提供了显式加载的原生API，专门用于加载单个导航属性，完全符合你的需求，比你当前的写法更高效简洁。

直接使用原生API #

可以通过DbContext.Entry()获取实体的跟踪条目，然后针对单个导航属性调用Load()方法：

// 检查Child导航属性是否已加载，未加载则触发加载
if (!_dbContext.Entry(foo).Reference(f => f.Child).IsLoaded)
{
    _dbContext.Entry(foo).Reference(f => f.Child).Load();
}

// 此时foo.Child已被加载
var child = foo.Child;

封装成你想要的EnsureLoaded扩展方法 #

如果希望写法更简洁，可以封装一个扩展方法，实现类似你设想的EnsureLoaded效果：

public static class DbContextExtensions
{
    // 同步版本
    public static TProperty EnsureLoaded<TEntity, TProperty>(this DbContext context, TEntity entity, Expression<Func<TEntity, TProperty>> navigationProperty)
        where TEntity : class
    {
        var entry = context.Entry(entity);
        var referenceEntry = entry.Reference(navigationProperty);

        if (!referenceEntry.IsLoaded)
        {
            referenceEntry.Load();
        }

        return referenceEntry.CurrentValue;
    }

    // 异步版本（适合异步场景）
    public static async Task<TProperty> EnsureLoadedAsync<TEntity, TProperty>(this DbContext context, TEntity entity, Expression<Func<TEntity, TProperty>> navigationProperty, CancellationToken cancellationToken = default)
        where TEntity : class
    {
        var entry = context.Entry(entity);
        var referenceEntry = entry.Reference(navigationProperty);

        if (!referenceEntry.IsLoaded)
        {
            await referenceEntry.LoadAsync(cancellationToken);
        }

        return referenceEntry.CurrentValue;
    }
}

使用这个扩展方法的写法就和你期望的一致了：

// 同步调用
var child = _dbContext.EnsureLoaded(foo, f => f.Child);

// 异步调用
var child = await _dbContext.EnsureLoadedAsync(foo, f => f.Child);

补充说明 #

• 原生的显式加载API只会加载指定的导航属性，不会加载其他无关属性，完全符合你“只加载指定属性”的需求。
• 相比你原来重新查询整个Foo实体再取Child的写法，显式加载直接利用已有的ChildId去查询对应的Child实体，避免了重复查询Foo，效率更高。

内容的提问来源于stack exchange，提问作者THX-1138