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