QueryableExtensions.Include 方法 (IQueryable, String)
[本页针对的是实体框架版本 6。最新版本以“实体框架”NuGet 包的形式提供。有关实体框架的更多信息，请参见 msdn.com/data/ef。]
指定要包括在查询结果中的相关对象。
命名空间： System.Data.Entity
程序集： EntityFramework（在 EntityFramework.dll 中）
语法
声明
<ExtensionAttribute> _
Public Shared Function Include ( _
source As IQueryable, _
path As String _
) As IQueryable
用法
Dim source As IQueryable
Dim path As String
Dim returnValue As IQueryable
returnValue = source.Include(path)
public static IQueryable Include(
this IQueryable source,
string path
)
[ExtensionAttribute]
public:
static IQueryable^ Include(
IQueryable^ source,
String^ path
)
static member Include :
source:IQueryable *
path:string -> IQueryable
public static function Include(
source : IQueryable,
path : String
) : IQueryable
参数
- source
类型：System.Linq.IQueryable
要在其上调用 Include 的源 IQueryable。
- path
类型：System.String
要在查询结果中返回的相关对象列表（以点号分隔）。
返回值
类型：System.Linq.IQueryable
一个新的 IQueryable，它具有定义的查询路径。
使用说明
在 Visual Basic 和 C# 中，可以在 IQueryable 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。有关详细信息，请参阅https://msdn.microsoft.com/zh-cn/library/bb384936(v=vs.113)或https://msdn.microsoft.com/zh-cn/library/bb383977(v=vs.113)。
备注
此扩展方法会调用源 IQueryable 对象的 Include(String) 方法（如果该方法存在）。 如果源 IQueryable 没有匹配的方法，则此方法不执行任何操作。 ObjectQuery、ObjectSet<TEntity>、DbQuery 和 DbSet 类型都会调用适当的 Include 方法。 路径是完全内包含的。 例如，如果一个包含调用指示 Include("Orders.OrderLines")，则不仅包含 OrderLines，而且包含 Orders。 在调用 Include 方法时，查询路径仅在 IQueryable 的返回实例上有效。 不影响 IQueryable 的其他实例和对象上下文本身。 因为 Include 方法返回查询对象，所以可以对一个 IQueryable 多次调用此方法，从而为查询指定多个路径。