EntityFrameworkQueryableExtensions.Include 方法

定义

命名空间:

Microsoft.EntityFrameworkCore

程序集:

Microsoft.EntityFrameworkCore.dll

程序包:

Microsoft.EntityFrameworkCore v10.0.0

重载

名称	说明
Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)	指定要包含在查询结果中的相关实体。 从要查询TEntity的实体类型（） 开始指定要包含的导航属性。 如果希望基于所包含类型的导航属性包含其他类型，请在此调用后链接调用 ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) 。
Include<TEntity>(IQueryable<TEntity>, String)	指定要包含在查询结果中的相关实体。 从要查询TEntity的实体类型（） 开始指定要包含的导航属性。 可以追加要包含的进一步导航属性，用“.”字符分隔。

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

Source:

EntityFrameworkQueryableExtensions.cs

指定要包含在查询结果中的相关实体。 从要查询TEntity的实体类型（） 开始指定要包含的导航属性。 如果希望基于所包含类型的导航属性包含其他类型，请在此调用后链接调用 ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) 。

public static Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,TProperty> Include<TEntity,TProperty>(this System.Linq.IQueryable<TEntity> source, System.Linq.Expressions.Expression<Func<TEntity,TProperty>> navigationPropertyPath) where TEntity : class;

static member Include : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * System.Linq.Expressions.Expression<Func<'Entity, 'Property>> -> Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, 'Property (requires 'Entity : null)> (requires 'Entity : null)

<Extension()>
Public Function Include(Of TEntity As Class, TProperty As Class) (source As IQueryable(Of TEntity), navigationPropertyPath As Expression(Of Func(Of TEntity, TProperty))) As IIncludableQueryable(Of TEntity, TProperty)

类型参数

TEntity

要查询的实体的类型。

TProperty

要包含的相关实体的类型。

参数

source

IQueryable<TEntity>

源查询。

navigationPropertyPath

Expression<Func<TEntity,TProperty>>

一个 lambda 表达式，表示要包含的导航属性（t => t.Property1）。

返回

IIncludableQueryable<TEntity,TProperty>

包含相关数据的新查询。

例外

ArgumentNullException

source 或 navigationPropertyPath 为 null.

示例

以下查询显示包括单个级别的相关实体：

context.Blogs.Include(blog => blog.Posts)

以下查询显示在同一分支上包括两个级别的实体：

context.Blogs
   .Include(blog => blog.Posts).ThenInclude(post => post.Tags)

以下查询显示相关数据的多个级别和分支：

context.Blogs
   .Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
   .Include(blog => blog.Contributors)

以下查询演示如何使用强制转换在派生类型上包括单个级别的相关实体：

context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)

以下查询显示使用“as”运算符在派生类型上包括单个级别的相关实体：

context.Blogs.Include(blog => (blog as SpecialBlog).SpecialPosts)

注解

有关详细信息和示例，请参阅 “加载相关实体 ”。

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

Source:

EntityFrameworkQueryableExtensions.cs

指定要包含在查询结果中的相关实体。 从要查询TEntity的实体类型（） 开始指定要包含的导航属性。 可以追加要包含的进一步导航属性，用“.”字符分隔。

public static System.Linq.IQueryable<TEntity> Include<TEntity>(this System.Linq.IQueryable<TEntity> source, string navigationPropertyPath) where TEntity : class;

static member Include : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * string -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)

<Extension()>
Public Function Include(Of TEntity As Class) (source As IQueryable(Of TEntity), navigationPropertyPath As String) As IQueryable(Of TEntity)

类型参数

TEntity

要查询的实体的类型。

参数

source

IQueryable<TEntity>

源查询。

navigationPropertyPath

String

要包含的“.”分隔导航属性名称的字符串。

返回

IQueryable<TEntity>

包含相关数据的新查询。

例外

ArgumentNullException

source 或 navigationPropertyPath 为 null.

ArgumentException

navigationPropertyPath 为空或空格。

示例

以下查询显示包括单个级别的相关实体：

context.Blogs.Include("Posts")

以下查询显示在同一分支上包括两个级别的实体：

context.Blogs.Include("Posts.Tags")

以下查询显示相关数据的多个级别和分支：

context.Blogs
   .Include("Posts.Tags.TagInfo')
   .Include("Contributors")

注解

有关详细信息和示例，请参阅 “加载相关实体 ”。