QueryableExtensions.Include 方法

定义

命名空间:

System.Data.Entity

程序集:

EntityFramework.dll

重载

Include(IQueryable, String)	指定要包括在查询结果中的相关对象。
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)	指定要包括在查询结果中的相关对象。
Include<T>(IQueryable<T>, String)	指定要包括在查询结果中的相关对象。

Include(IQueryable, String)

指定要包括在查询结果中的相关对象。

public static System.Linq.IQueryable Include (this System.Linq.IQueryable source, string path);

static member Include : System.Linq.IQueryable * string -> System.Linq.IQueryable

<Extension()>
Public Function Include (source As IQueryable, path As String) As IQueryable

参数

source

IQueryable

要对其调用 Include 的源 IQueryable 。

path

String

要在查询结果中返回的相关对象列表（以点号分隔）。

返回

IQueryable

一个新的 IQueryable，它具有定义的查询路径。

注解

此扩展方法调用源 IQueryable 对象的 Include (String) 方法（如果存在此类方法）。 如果源 IQueryable 没有匹配的方法，则此方法不执行任何工作。 ObjectQuery、 ObjectSet<TEntity>DbQuery 和 DbSet 类型都有相应的 Include 方法要调用。 路径是完全内包含的。 例如，如果 include 调用指示 Include (“Orders.OrderLines”) ，则不仅将包括 OrderLines，还会包含 Orders。 调用 Include 方法时，查询路径仅在 返回的 实例上 IQueryable有效。 不影响 IQueryable 的其他实例和对象上下文本身。 由于 Include 方法返回查询对象，因此可以在 上 IQueryable 多次调用此方法以指定查询的多个路径。

Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)

指定要包括在查询结果中的相关对象。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
public static System.Linq.IQueryable<T> Include<T,TProperty> (this System.Linq.IQueryable<T> source, System.Linq.Expressions.Expression<Func<T,TProperty>> path);

static member Include : System.Linq.IQueryable<'T> * System.Linq.Expressions.Expression<Func<'T, 'Property>> -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T, TProperty) (source As IQueryable(Of T), path As Expression(Of Func(Of T, TProperty))) As IQueryable(Of T)

类型参数

T

正在查询的实体的类型。

TProperty

要包括的导航属性的类型。

参数

source

IQueryable<T>

要在其上调用 Include 的源 IQueryable。

path

Expression<Func<T,TProperty>>

表示要包括的路径的 lambda 表达式。

返回

IQueryable<T>

具有定义的查询路径的新 IQueryable<T> 。

属性

SuppressMessageAttribute

注解

路径表达式必须由简单的属性访问表达式和对 Select 的调用组成，以便在包括集合属性后编写其他包含项。 可能的包含路径的示例包括：包含单个引用：查询。包含 (e => e.Level1Reference) 包含单个集合：查询。包括 (e => e.Level1Collection) 包括引用，然后引用一个级别：查询。包括 (e => e.Level1Reference.Level2Reference) 包括引用，然后包含集合一个级别：查询。包括 (e => e.Level1Reference.Level2Collection) 包含集合，然后引用下一个级别：查询。包括 (e => e.Level1Collection.Select (l1 => l1。Level2Reference) ) 将集合和集合包含在一个级别下：查询。包括 (e => e.Level1Collection.Select (l1 => l1。Level2Collection) ) 包含集合，然后向下引用一个级别：查询。包括 (e => e.Level1Collection.Select (l1 => l1。Level2Reference) ) 将集合和集合包含在一个级别下：查询。包括 (e => e.Level1Collection.Select (l1 => l1。Level2Collection) ) 包含集合、引用和引用两个级别：查询。包括 (e => e.Level1Collection.Select (l1 => l1。Level2Reference.Level3Reference) ) 包含集合、集合和引用两个级别：查询。包括 (e => e.Level1Collection.Select (l1 => l1。Level2Collection.Select (l2 => l2。Level3Reference) ) ) 此扩展方法调用源 IQueryable 对象的 Include (String) 方法（如果存在此类方法）。 如果源 IQueryable 没有匹配的方法，则此方法不执行任何操作。 Entity Framework ObjectQuery、ObjectSet、DbQuery 和 DbSet 类型都有相应的 Include 方法要调用。 调用 Include 方法时，查询路径仅在返回的 IQueryable<T> 实例上有效。 IQueryable<T> 的其他实例和对象上下文本身不受影响。 由于 Include 方法返回查询对象，因此可以在 IQueryable<T> 上多次调用此方法，以指定查询的多个路径。

Include<T>(IQueryable<T>, String)

指定要包括在查询结果中的相关对象。

public static System.Linq.IQueryable<T> Include<T> (this System.Linq.IQueryable<T> source, string path);

static member Include : System.Linq.IQueryable<'T> * string -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T) (source As IQueryable(Of T), path As String) As IQueryable(Of T)

类型参数

T

正在查询的实体的类型。

参数

source

IQueryable<T>

要对其调用 Include 的源 IQueryable<T> 。

path

String

要在查询结果中返回的相关对象列表（以点号分隔）。

返回

IQueryable<T>

一个新的 IQueryable<T>，它具有定义的查询路径。

注解

此扩展方法调用源 IQueryable<T> 对象的 Include (String) 方法（如果存在此类方法）。 如果源 IQueryable<T> 没有匹配的方法，则此方法不执行任何工作。 ObjectQuery<T>、 ObjectSet<TEntity>DbQuery<TResult> 和 DbSet<TEntity> 类型都有相应的 Include 方法要调用。 路径是完全内包含的。 例如，如果 include 调用指示 Include (“Orders.OrderLines”) ，则不仅将包括 OrderLines，还会包含 Orders。 调用 Include 方法时，查询路径仅在 返回的 实例上 IQueryable<T>有效。 不影响 IQueryable<T> 的其他实例和对象上下文本身。 由于 Include 方法返回查询对象，因此可以在 上 IQueryable<T> 多次调用此方法以指定查询的多个路径。