LINQ to Entities

[アーティクル]
05/10/2023

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

ObjectQuery<T> から ObjectContext インスタンスを作成します。
ObjectQuery<T> インスタンスを使用して、C# または Visual Basic で LINQ to Entities クエリを作成します。
LINQ 標準クエリ演算子および標準クエリ式をコマンドツリーに変換します。
コマンドツリーで表されたクエリをデータソースに対して実行します。実行中にデータソースに対してスローされた例外は、クライアントに直接渡されます。
クエリの結果をクライアントに返します。

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 標準クエリ演算子 (Select、Where、GroupBy など) と式 (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 とのマッピングができないことが原因でエラーが発生すると、オブジェクトの具体化中に例外がスローされます。

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