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 に一致するメソッドがない場合、このメソッドは何も行いません。 、ObjectSet<TEntity>、DbQueryおよび DbSet 型はすべて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>>

含めるパスを表すラムダ式。

戻り値

IQueryable<T>

定義されたクエリ パスを持つ新しい IQueryable<T> 。

属性

SuppressMessageAttribute

注釈

パス式は、コレクションプロパティを含めた後に追加のインクルードを作成するための Select の呼び出しと共に、単純なプロパティ アクセス式で構成する必要があります。 可能なインクルード パスの例は、1 つの参照を含めるには、クエリです。Include(e => e.Level1Reference) 単一のコレクションを含めるには、 query。Include(e => e.Level1Collection) 参照を含めてから、1 レベル下の参照を含めるには、query。Include(e => e.Level1Reference.Level2Reference) 参照を含め、次にコレクションを 1 レベル下に含めるには、query。Include(e => e.Level1Reference.Level2Collection) コレクションを含めてから、1 レベル下の参照を含めるには、query。Include(e => e.Level1Collection.Select(l1 => l1.Level2Reference)) コレクションを含めてから 1 レベル下のコレクションを含めるには、query。Include(e => e.Level1Collection.Select(l1 => l1.Level2Collection)) コレクションを含め、次に 1 レベル下の参照を含めるには、query。Include(e => e.Level1Collection.Select(l1 => l1.Level2Reference)) コレクションを含めてから 1 レベル下のコレクションを含めるには、query。Include(e => e.Level1Collection.Select(l1 => l1.Level2Collection)) コレクション、参照、および参照を 2 レベル下に含めるには、query。Include(e => e.Level1Collection.Select(l1 => l1.Level2Reference.Level3Reference)) コレクション、コレクション、および参照を 2 レベル下に含めるには、 query。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>。

注釈

このようなメソッドが存在する場合、この拡張メソッドはソース IQueryable<T> オブジェクトの Include(String) メソッドを呼び出します。 ソース IQueryable<T> に一致するメソッドがない場合、このメソッドは何も行いません。 、ObjectSet<TEntity>、DbQuery<TResult>および DbSet<TEntity> 型はすべてObjectQuery<T>、呼び出す適切な Include メソッドを持っています。 パスは包括的です。 たとえば、include 呼び出しで Include("Orders.OrderLines") が示されている場合、OrderLines は含まれるだけでなく、Orders も含まれます。 Include メソッドを呼び出すと、クエリ パスは の返されたインスタンス IQueryable<T>でのみ有効です。 IQueryable<T> の他のインスタンスとオブジェクト コンテキスト自体は影響を受けません。 Include メソッドはクエリ オブジェクトを返すので、 で IQueryable<T> このメソッドを複数回呼び出して、クエリの複数のパスを指定できます。