QueryableExtensions.Include 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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 对象的 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> 。
- 属性
注解
路径表达式必须由简单的属性访问表达式和对 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> 对象的 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> 多次调用此方法以指定查询的多个路径。
