次の方法で共有


LINQ to Entities

LINQ to Entities は、開発者が Visual Basic または Visual C# を使用して Entity Framework 概念モデルに対するクエリを作成するための統合言語クエリ (LINQ) のサポートを提供します。 Entity Framework に対するクエリで代表的なものが、コマンド ツリー クエリです。これはオブジェクト コンテキストに対して実行されます。 LINQ to Entities では、統合言語クエリ (LINQ) クエリをコマンド ツリー クエリに変換し、そのクエリを Entity Framework に対して実行します。返されたオブジェクトは、Entity Framework でも LINQ でも使用できます。 次に、LINQ to Entities クエリを作成して実行する手順を示します。

  1. ObjectQuery<T> から ObjectContext インスタンスを作成します。

  2. ObjectQuery<T> インスタンスを使用して、C# または Visual Basic で LINQ to Entities クエリを作成します。

  3. LINQ 標準クエリ演算子および標準クエリ式をコマンド ツリーに変換します。

  4. コマンド ツリーで表されたクエリをデータ ソースに対して実行します。 実行中にデータ ソースに対してスローされた例外は、クライアントに直接渡されます。

  5. クエリの結果をクライアントに返します。

ObjectQuery インスタンスの構築

ObjectQuery<T> ジェネリック クラスは、0 個以上の型指定されたエンティティのコレクションを返すクエリを表します。 通常、オブジェクト クエリは手作業で構築されるのではなく、既存のオブジェクト コンテキストから構築され、常にそのオブジェクト コンテキストに属しています。 このコンテキストにより、クエリの作成と実行に必要な接続情報とメタデータ情報が取得されます。 ObjectQuery<T> ジェネリック クラスでは、IQueryable<T> ジェネリック インターフェイスが実装されます。このインターフェイスのビルダー メソッドにより、LINQ クエリを段階的に構築できます。 C# var キーワード (Visual Basic の場合は Dim、ローカル型推論を有効にする) を使用することで、コンパイラでエンティティの型を推論することもできます。

クエリの作成

ObjectQuery<T> ジェネリック インターフェイスを実装する IQueryable<T> ジェネリック クラスのインスタンスは、LINQ to Entities クエリのデータ ソースとして動作します。 クエリでは、データ ソースから取得する情報を正確に指定できます。 また、並べ替え、グループ化、整形方法を指定して情報を取得することもできます。 LINQ では、クエリが変数に格納されます。 このクエリ変数は、クエリの情報を保存するだけで、なんらかのアクションを実行したり、データを返したりすることはありません。 クエリを作成した後、データを取得するには、そのクエリを実行する必要があります。

LINQ to Entities クエリは、クエリ式の構文とメソッド ベースのクエリ構文という 2 とおりの構文を使って作成できます。 クエリ式の構文とメソッド ベースのクエリ構文は、C# 3.0 と Visual Basic 9.0 で新たに導入された機能です。

詳しくは、「LINQ to Entities でのクエリ」をご覧ください。

クエリの変換

LINQ to Entities クエリを Entity Framework に対して実行するには、LINQ クエリを Entity Framework に対して実行できるコマンド ツリー表現に変換する必要があります。

LINQ to Entities クエリは、LINQ 標準クエリ演算子 (SelectWhereGroupBy など) と式 (x > 10 や Contact.LastName など) で構成されます。 LINQ 演算子はクラスで定義されるものではなく、クラスのメソッドです。 LINQ の式には、System.Linq.Expressions 名前空間の型で許容される要素だけでなく、ラムダ関数で表される要素であれば何でも使用できます。 これは Entity Framework で許容される式のスーパーセットです。定義により、このような式はデータベースで許容され、ObjectQuery<T> でサポートされる操作に限定されています。

Entity Framework では、演算子と式は 1 つの型の階層で表された後、コマンド ツリーに配置されます。 このコマンド ツリーが、Entity Framework でのクエリの実行に使用されます。 LINQ クエリをコマンド ツリーとして表現できない場合、クエリの変換中に例外がスローされます。 LINQ to Entities クエリを変換する際には、標準クエリ演算子の変換と式の変換という 2 つの変換が実行されます。

LINQ to Entities で正しく変換されない LINQ 標準クエリ演算子は多数あります。 このような演算子を使用すると、クエリの変換時に例外が発生します。 サポートされている LINQ to Entities の演算子の一覧については、「サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド (LINQ to Entities)」をご覧ください。

LINQ to Entities の標準クエリ演算子の使用方法の詳細については、「LINQ to Entities クエリの標準クエリ演算子」をご覧ください。

一般的に、LINQ to Entities の式はサーバー上で評価されるため、式の動作が CLR セマンティクスに従っているとは限りません。 詳しくは、「LINQ to Entities クエリ内の式」をご覧ください。

CLR メソッドの呼び出しがデータ ソースの正規関数にどのようにマップされるかについては、「CLR メソッドと正規関数とのマッピング」をご覧ください。

LINQ to Entities のクエリから正規関数、データベース関数、カスタム関数を呼び出す方法については、「LINQ to Entities クエリ内の関数の呼び出し」をご覧ください。

クエリの実行

ユーザーが LINQ クエリを作成すると、Entity Framework と互換性のある表現 (コマンド ツリーの形) に変換された後、データ ソースに対して実行されます。 クエリの実行時に、すべてのクエリ式 (またはクエリの構成要素) がクライアントまたはサーバー上で評価されます。 これには、結果の具体化やエンティティの投影で使用される式も含まれます。 詳しくは、「クエリの実行」をご覧ください。 クエリを 1 回コンパイルしてから、異なるパラメーターを使用して数回実行することでパフォーマンスを向上させる方法については、「コンパイル済みクエリ (LINQ to Entities)」をご覧ください。

具体化

具体化は、クエリの結果を CLR 型としてクライアントに返すプロセスです。 LINQ to Entities では、クエリの結果のデータ レコードは決して返されません。常に返されるのは、ユーザーまたは Entity Framework で定義された CLR 型、またはコンパイラによって生成される CLR 型 (匿名型) です。 オブジェクトの具体化は、すべて Entity Framework によって実行されます。 Entity Framework と CLR とのマッピングができないことが原因でエラーが発生すると、オブジェクトの具体化中に例外がスローされます。

通常、クエリの結果は次のいずれかの形で返されます。

  • 0 個以上の型指定されたエンティティ オブジェクトのコレクション、または概念モデルで定義されている複合型のプロジェクション。

  • Entity Framework でサポートされる CLR 型。

  • インライン コレクション。

  • 匿名型。

詳しくは、「クエリ結果」をご覧ください。

このセクションの内容

LINQ to Entities でのクエリ

LINQ to Entities クエリ内の式

LINQ to Entities クエリ内の関数の呼び出し

コンパイル済みクエリ (LINQ to Entities)

クエリの実行

クエリ結果

LINQ to Entities クエリの標準クエリ演算子

CLR メソッドと正規関数とのマッピング

サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド (LINQ to Entities)

LINQ to Entities の既知の問題および注意点

関連項目