QueryableExtensions.Include<T> メソッド (IQueryable<T>, String)
[このページは、Entity Framework 6 に関するページです。最新バージョンは、'Entity Framework' NuGet パッケージとして入手できます。Entity Framework の詳細については、msdn.com/data/ef を参照してください。]
クエリ結果に含める関連オブジェクトを指定します。
名前空間: System.Data.Entity
アセンブリ: EntityFramework (EntityFramework.dll 内)
構文
'宣言
<ExtensionAttribute> _
Public Shared Function Include(Of T) ( _
source As IQueryable(Of T), _
path As String _
) As IQueryable(Of T)
'使用
Dim source As IQueryable(Of T)
Dim path As String
Dim returnValue As IQueryable(Of T)
returnValue = source.Include(path)
public static IQueryable<T> Include<T>(
this IQueryable<T> source,
string path
)
[ExtensionAttribute]
public:
generic<typename T>
static IQueryable<T>^ Include(
IQueryable<T>^ source,
String^ path
)
static member Include :
source:IQueryable<'T> *
path:string -> IQueryable<'T>
JScript does not support generic types and methods.
型パラメーター
- T
照会するエンティティの型。
パラメーター
- source
型 : System.Linq.IQueryable<T>
Include を呼び出す対象のソース IQueryable<T>。
- path
型 : System.String
クエリ結果で返す関連オブジェクトをドットで区切った一覧。
戻り値
型 : System.Linq.IQueryable<T>
定義されたクエリ パスを使用する新しい IQueryable<T>。
使用上の注意
Visual Basic および Visual C# では、このメソッドを、IQueryable<T> 型のオブジェクトのインスタンス メソッドとして呼び出すことができます。インスタンス メソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。詳細については、「https://msdn.microsoft.com/ja-jp/library/bb384936(v=vs.113)」または「https://msdn.microsoft.com/ja-jp/library/bb383977(v=vs.113)」を参照してください。
解説
この拡張メソッドはソース IQueryable<T> オブジェクトの Include(String) メソッドを呼び出します (存在する場合)。 ソース IQueryable<T> に一致するメソッドが存在しない場合、このメソッドは何も行いません。 ObjectQuery<T>、ObjectSet<TEntity>、DbQuery<TResult>、および DbSet<TEntity> 型のすべてで、適切な Include メソッドを呼び出す必要があります。 パスは包括的です。 たとえば、インクルード呼び出しで Include("Orders.OrderLines") が指定されている場合は、OrderLines だけではなく Orders も含まれます。 Include メソッドを呼び出した場合、クエリ パスは IQueryable<T> の返されたインスタンスでのみ有効です。 IQueryable<T> の他のインスタンスとオブジェクト コンテキスト自体は影響を受けません。 Include メソッドはクエリ オブジェクトを返すので、このメソッドを IQueryable<T> で複数回呼び出すことで、クエリに複数のパスを指定できます。