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 没有匹配的方法,则此方法不执行任何操作。 ObjectSet<TEntity> DbSet DbQuery和ObjectQuery类型都具有相应的 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 的调用,以便在包括集合属性之后编写其他包含项。 可能的包括路径的示例包括:若要包含单个引用:查询。Include(e => e.Level1Reference) 若要包含单个集合:查询。Include(e => e.Level1Collection) 若要包含引用,然后引用一个级别向下:查询。Include(e => e.Level1Reference.Level2Reference) 若要包含引用,然后一个集合向下一级:查询。Include(e => e.Level1Reference.Level2Collection) 若要包含集合,然后引用一个级别向下:查询。Include(e => e.Level1Collection.Select(l1 => l1.Level2Reference)若要包含集合,然后包含一个下一级集合:查询。Include(e => e.Level1Collection.Select(l1 => l1.Level2Collection))若要包含集合,然后引用一个级别向下:查询。Include(e => e.Level1Collection.Select(l1 => l1.Level2Reference)若要包含集合,然后包含一个下一级集合:查询。Include(e => e.Level1Collection.Select(l1 => l1.Level2Collection))若要包括集合、引用和引用两个级别,请向下查询。Include(e => e.Level1Collection.Select(l1 => l1.Level2Reference.Level3Reference)若要包含集合、集合和引用两个级别,请向下查询。Include(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> 没有匹配的方法,则此方法不执行任何操作。 ObjectSet<TEntity> DbSet<TEntity> DbQuery<TResult>和ObjectQuery<T>类型都具有相应的 Include 方法来调用。 路径是独占的。 例如,如果 include 调用指示 Include(“Orders.OrderLines”),不仅包括 OrderLines,而且还包括 Orders。 调用 Include 方法时,查询路径仅在返回的 IQueryable<T>实例上有效。 其他实例 IQueryable<T> 和对象上下文本身不受影响。 由于 Include 方法返回查询对象,因此可以在指定 IQueryable<T> 查询的多个路径时多次调用此方法。