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>및 DbQueryDbSet 형식에는 모두 호출할 적절한 Include 메서드가 있습니다. 경로는 모두 포함됩니다. 예를 들어 include 호출이 Include("Orders.OrderLines")를 나타내는 경우 OrderLines뿐만 아니라 Orders도 포함됩니다. Include 메서드를 호출하면 쿼리 경로는 의 IQueryable반환된 instance만 유효합니다. 및 개체 컨텍스트 자체의 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>>

포함할 경로를 나타내는 람다 식입니다.

반환

IQueryable<T>

정의된 쿼리 경로가 있는 새 IQueryable<T> 입니다.

특성

SuppressMessageAttribute

설명

경로 식은 컬렉션 속성을 포함한 후 추가 포함을 작성하기 위해 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>의 반환된 instance만 유효합니다. 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>반환된 instance만 유효합니다. 및 개체 컨텍스트 자체의 IQueryable<T> 다른 인스턴스는 영향을 받지 않습니다. Include 메서드는 쿼리 개체를 반환하므로 에서 이 메서드를 IQueryable<T> 여러 번 호출하여 쿼리에 대한 여러 경로를 지정할 수 있습니다.