Docs Menu
Docs Home
/
言語
/
C#/.NET
/
C#/.NET

クイック スタート

項目一覧

  • MongoDB クラスターを作成する
  • Atlas での無料階層クラスターを設定する
  • 接続文字列を設定する
  • プロジェクトを設定する
  • プロジェクトを作成する
  • MongoDB を依存関係として追加する
  • アプリケーションから MongoDB クラスターをクエリする
  • 次のステップ

このガイドでは、.NET/C# ドライバー を使用して MongoDB Atlas クラスターに接続するアプリケーションを作成する方法について説明します。別のドライバーまたはプログラミング言語を使用して MongoDB に接続する場合は、公式 MongoDB ドライバーのリストを参照してください。

.NET/C# ドライバーを使用すると、.NET アプリケーションから MongoDB クラスターに接続して通信できます。

MongoDB Atlas は、MongoDB クラスターでデータをホストする完全管理クラウドデータベース サービスです。このガイドでは、独自の無料クラスター（クレジットカードは不要）を開始する方法を説明します。

.NET アプリケーションを MongoDB Atlas クラスターに接続するには、以下の手順に従います。

MongoDB クラスターを作成する

Atlas での無料階層クラスターを設定する

このガイドに必要な Atlas 無料階層クラスターをセットアップするには、 MongoDB Atlas セットアップのガイドを完了させてください。

Atlas ガイドの手順を完了すると、Atlas に新しい MongoDB クラスターが配置され、新しいデータベースユーザーが作成され、クラスターにサンプル データセットがロードされます。また、コピー バッファには次のような接続文字列があります。

"mongodb+srv://<db_username>:<db_password>@cluster0.abc.mongodb.net/?retryWrites=true&w=majority"

接続文字列を設定する

コマンドプロンプトで次のコードを実行して、 MongoDB 接続stringを環境変数に保存します。 この方法は、ソースコードに認証情報を含めるよりも安全です。

export MONGODB_URI="<your MongoDB URI>"

注意

PowerShell 環境変数

Microsoft PowerShell を使用している場合は、次のコマンドを実行して接続文字列を環境変数に保存します。

set MONGODB_URI="<your MongoDB URI>"

重要

接続 <db_username>の {0<db_password>string セクションと セクションを、Atlas データベースユーザーのユーザー名とパスワードに置き換えてください。

接続文字列の詳細については、「接続文字列」を参照してください。

プロジェクトを設定する

プロジェクトを作成する

次のように、新しいディレクトリを作成し、dotnet new コマンドを使用してプロジェクトを初期化します。

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

MongoDB を依存関係として追加する

dotnet add コマンドを使用して、.NET/C# ドライバーを依存関係としてプロジェクトに追加します。

dotnet add package MongoDB.Driver

アプリケーションから MongoDB クラスターをクエリする

この手順では、.NET/C# ドライバーを使用して MongoDB クラスターに接続し、サンプル データに対してクエリを実行します。お好みのテキストエディタまたは統合開発環境 (IDE) をインストールし、実行することが必要です。

プロジェクトのベース ディレクトリにある Program.cs という名前のファイルを開きます。次のサンプル コードを Program.cs にコピーします

using MongoDB.Driver;
using MongoDB.Bson;
var connectionString = Environment.GetEnvironmentVariable("MONGODB_URI");
if (connectionString == null)
{
    Console.WriteLine("You must set your 'MONGODB_URI' environmental variable. See\n\t https://www.mongodb.com/ja-jp/docs/drivers/csharp/current/quick-start/#set-your-connection-string");
    Environment.Exit(0);
}
var client = new MongoClient(connectionString);
var collection = client.GetDatabase("sample_mflix").GetCollection<BsonDocument>("movies");
var filter = Builders<BsonDocument>.Filter.Eq("title", "Back to the Future");
var document = collection.Find(filter).First();
Console.WriteLine(document);

このサンプル コードは、MongoDB Atlas のサンプル データセットに対してクエリを実行します。 次のコマンドを使用して、コマンドラインから実行します。

dotnet run csharp-quickstart.csproj

Program.cs を実行すると、サンプル データセットから次の映画の詳細が出力されます。

{
    "_id": "573a1398f29313caabce9682",
    ...
    "title": "Back to the Future",
    ...
}

Tip

出力が空の場合は、サンプル データセットがクラスターにロードされていることを確認してください。

この手順を完了すると、.NET/C# ドライバーを使用して MongoDB クラスターに接続し、サンプル データに対してクエリを実行し、結果を出力する動作するアプリケーションが作成されます。

.NET/C# ドライバーを使用して Atlas に接続する方法について詳しくは、Atlas ドライバー接続ガイドを参照し、Select your language ドロップダウンから C# を選択してください。

次のステップ

CRUD 操作ガイドでは、.NET/C# ドライバーを使用してデータを読み取って変更する方法、または使用例では、一般的な操作を実行する方法を学習します。

戻る

以前のバージョン