クエリ データ
Overview
Entity Framework コアを使用すると、データベースコマンドを明示的に実行せずにアプリケーション内のデータを操作できます。 データをクエリするには、 LINQ(言語統合クエリ) 構文を使用します。 LINQ では、C# 固有のキーワードと演算子を使用して、厳密に型指定されたクエリを作成できます。 アプリケーションを実行すると、F Core プロバイダーは LINQ クエリを自動的に変換し、MongoDB Query API を使用してデータベース上で実行します。
このガイドでは、FS コア プロバイダーを使用するように構成されたアプリケーションにおける一般的なクエリ操作の例を確認できます。
Tip
FS コア プロバイダーを使用するようにアプリケーションを構成する方法については、「 FS コアの構成 」を参照してください。
エンティティの検索
FirstOrDefault()
メソッドを使用して 1 つのエンティティを検索するか、 Where()
メソッドを使用して複数のエンティティを検索します。
単一エンティティの検索
FirstOrDefault()
メソッドは、コレクション内で検索条件に一致する最初に見つけたエンティティを返し、一致するエンティティが見つからない場合はnull
を返します。
次のコードでは、 Planets
FirstOrDefault()
name
を使用して、 DBSet
(
var planet = db.Planets.FirstOrDefault(p => p.name == "Mercury"); Console.WriteLine(planet.name);
複数エンティティの検索
Where()
メソッドを使用して、コレクションから複数のエンティティを取得できます。 Where()
は、検索条件に一致するすべてのエンティティを返します。
次のコードでは、 Where()
メソッドを使用して、 hasRings
フィールドがtrue
に設定されているすべての惑星を検索し、惑星名をコンソールに出力します。
var planets = db.Planets.Where(p => p.hasRings); foreach (var p in planets) { Console.WriteLine(p.name); }
ソート エンティティ
クエリからエンティティを返す順序を指定するには、 OrderBy()
メソッドを使用します。 OrderBy()
は、指定された並べ替え条件に基づいて要素を昇順で並べ替えます。
次のコードでは、 OrderBy()
メソッドを使用してすべての惑星を検索し、 orderFromSun
フィールドの値で昇順に並べ替えます。 次に、結果をコンソールに出力します。
var planetList = db.Planets.OrderBy(p => p.orderFromSun); foreach (var p in planetList) { Console.WriteLine(p.name); }
Mercury Venus Earth Mars Jupiter Saturn Uranus Neptune
Tip
降順でソート
OrderByDescending()
メソッドを使用して、クエリの結果を降順で並べ替えることができます。
ThenBy()
メソッドを使用して、クエリで 2 次並べ替えを実行できます。 ThenBy()
メソッドは、指定された並べ替え条件に基づいて、 OrderBy()
メソッドの結果を昇順で並べ替えます。 ThenBy()
メソッドはOrderBy()
メソッドに連結する必要があります。
Tip
降順での二次ソート
ThenByDescending()
メソッドを使用して、降順で二次並べ替えを実行できます。
次のコードでは、 OrderBy()
メソッドとThenBy()
メソッドを使用してすべての惑星を検索し、 hasRings()
フィールドで並べ替え、 name
フィールドで 2 次並べ替えます。
var planetList = db.Planets.OrderBy(o => o.hasRings).ThenBy(o => o.name); foreach (var p in planetList) { Console.WriteLine("Has rings: " + p.hasRings + ", Name: " + p.name); }
Has rings: False, Name: Earth Has rings: False, Name: Mars Has rings: False, Name: Mercury Has rings: False, Name: Venus Has rings: True, Name: Jupiter Has rings: True, Name: Neptune Has rings: True, Name: Saturn Has rings: True, Name: Uranus
Tip
ブール値を持つフィールドでソートすると、フィールド値がfalse
のエンティティがtrue
のフィールド値より前に表示されます。
詳細情報
このガイドで説明するメソッドの詳細については、次の .NET API ドキュメントへのリンクを参照してください。