.NET/ C#ドライバーを使い始める

プロジェクトディレクトリを作成します。

シェルで次のコマンドを実行して csharp-quickstart というディレクトリを作成し、新しい コンソールアプリケーションの.NETフレームワークプロジェクトを初期化します。

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

.NET/ C#ドライバーをインストールします。

次のコマンドを実行して、 .NET/ C#ドライバーの現在のバージョンをプロジェクトの依存関係 としてインストールします。

dotnet add package MongoDB.Driver

Atlas に無料のMongoDBデプロイを作成します。

MongoDB の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプルデータを新しい無料階層の MongoDB 配置にロードします。

認証情報を保存します。

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

MongoDB Atlas接続文字列を見つけます。

Clusters前のステップで作成した配置の接続文字列を取得するには、AtlasDatabase アカウントにログ、Connect セクションの下の ページに移動します。新しい配置で [] ボタンをクリックします。

データベースユーザーをまだ設定していない場合、 MongoDB は新しいユーザーを作成して設定するように要求します。

Connect to your application セクションの下の Drivers ボタンをクリックし、Driver 選択メニューと Version 選択メニューからインストールしたバージョンに最適化されたバージョンから [C# / .NET] を選択します。

接続文字列のみを表示するには、View full code sample オプションが選択されていないことを確認します。

接続文字列をコピーします。

次のスクリーンショットに示すように、接続stringの右側にある ボタンをクリックして、クリップボードにコピーします。

パスワード プレースホルダーを更新します。

この接続文字列をテキストエディタのファイルに貼り付け、<db_password> プレースホルダーをデータベースユーザーのパスワードに置き換えます。接続文字列には、すでにデータベースユーザーのユーザー名が入力されています。

このファイルを安全な場所に保存して、次の手順で使用します。

環境変数を設定します。

シェルで次のコードを実行して、MongoDB接続文字列を環境変数に保存します。<your MongoDB URI> を、前の手順でファイルに保存した接続文字列に置き換えます。

export MONGODB_URI="<your MongoDB URI>"

set MONGODB_URI="<your MongoDB URI>"

認証情報を環境変数に保存するのは、 ソースコードで認証情報をハードコーディングするよりも安全です。

.NET/ C#アプリケーションを作成します。

次のコードをコピーして、アプリケーション内の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' environment variable. To learn how to set it, see https://www.mongodb.com/ja-jp/docs/drivers/csharp/current/get-started/create-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.ToJson(new JsonWriterSettings { Indent = true }));

アプリケーションを実行します。

このアプリケーションを起動するには、shell で次のコマンドを実行します。

dotnet run csharp-quickstart.csproj

出力には、検索された映画ドキュメントの詳細が含まれます。

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}