EntityFrameworkQueryableExtensions.Include 메서드

정의

네임스페이스:

Microsoft.EntityFrameworkCore

어셈블리:

Microsoft.EntityFrameworkCore.dll

패키지:

Microsoft.EntityFrameworkCore v9.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>>

포함할 탐색 속성(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")

설명

자세한 내용 및 예제 는 관련 엔터티 로드 를 참조하세요.