LINQ 式の分析

Overview

LINQは、C# 言語に含まれるクエリ構文です。 .NET/C# ドライバーは、LINQ 式のサブセットを MongoDB 集計パイプラインに変換できます。

LINQ の詳細については、次のリソースを参照してください。

• .NET/C# ドライバーのドキュメントのLINQ

• Microsoft C#ガイドの LINQ

集計パイプラインの詳細については、MongoDB マニュアルの集計を参照してください。

C# Analyzerを使用して、LINQ 式に関する次の情報を学習します。

• LINQ 式は MongoDB Query API にどのように変換されるか

• LINQ 式のいずれかがサポートされていない場合

MongoDB Query API への変換

LINQ 式とそれに対応する MongoDB Query API の変換の例については、次のタブをクリックしてください。

var books = queryableCollection
       .Where(b =>
           b.Genre == genre &&
           b.Price >= minPrice &&
           b.Title.Contains(titleSearchTerm))
       .OrderBy(b => b.Price)
       .ToList();

[{ "$match" : {
     "Genre" : genre,
     "Price" : { "$gte" : minPrice },
     "Title" : /titleSearchTerm/s }
  },
  { "$sort" : { "Price" : 1 } }]

Visual Studio での LINQ の分析

Visual Studio で LINQ 式を分析するには、次のアクションを実行します。

1. インストールガイドの説明に沿って、C# Analyzer をインストールします。

2. .NET/C# ドライバーを使用して LINQ 式を記述します。

3. LINQ 式の最初のメソッドの下の ...注釈の上にマウスを移動すると、MongoDB Query API の翻訳を含む情報メッセージが表示されます。

単純な LINQ 式

C# Analyzerは、次の構文タイプの LINQ 式を分析します。

• メソッド構文

• クエリ構文

次の対応するタブをクリックすると、メソッド構文で記述された LINQ 式が情報メッセージの有無にかかわらず表示されます。

情報メッセージなし

情報メッセージ付き

次の対応するタブをクリックすると、クエリ構文で記述された LINQ 式が情報メッセージの有無にかかわらず表示されます。

情報メッセージなし

情報メッセージ付き

サポートされていない LINQ 式

LINQ 式がサポートされていない場合、C# Analyzer は MALinq2001警告を出力します。

次のコード スニペットには、サポートされていないGetHashCode LINQ 式が含まれています。

var result = queryableColl.Where(b => b.GetHashCode() == 167);

C# Analyzer はサポートされていない式に注釈を表示し、次の警告メッセージを生成します。

Expression not supported: b.GetHashCode().

次のスクリーンショットは、注釈付きのコードと、注釈にカーソルを合わせると表示される警告を示しています。

Tip

エラー リスト パネル

Visual Studio for Windowsを使用している場合は、 エラー リストウィンドウでC# Analyzer からの出力を表示できます。

詳細については、 Microsoftの「 エラー リスト ウィンドウ 」を参照してください。

サポートされていない LINQ 式の例をさらに見るには、 MongoDB C# Analyzer Githubリポジトリ を参照してください。

var result = queryableColl.Where(b => b.Title.Substring(0) == "Pane");

Supported in LINQ3 only: db.coll.Aggregate([{ "$match" : { "$expr" : { "$eq" : [{ "$substrCP" : ["$Title", 0, { "$subtract" : [{ "$strLenCP" : "$Title" }, 0] }] }, "Pane"] } } }])