Get Started with the .NET/C# Driver

Create a project directory.

In your shell, run the following commands to create a directory called csharp-quickstart and initialize a .NET framework project for a new console application:

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

Install the .NET/C# Driver.

Run the following command to install the current version of the .NET/C# Driver as a dependency of your project:

dotnet add package MongoDB.Driver

Create a free MongoDB deployment on Atlas.

Complete the MongoDB Get Started guide to set up a new Atlas account and load sample data into a new free tier MongoDB deployment.

Save your credentials.

After you create your database user, save that user's username and password to a safe location for use in an upcoming step.

Find your MongoDB Atlas connection string.

To retrieve your connection string for the deployment that you created in the previous step, log into your Atlas account and navigate to the Clusters page under the Database section. Click the Connect button for your new deployment.

If you do not already have a database user configured, MongoDB will prompt you to create and configure a new user.

Click the Drivers button under the Connect to your application section and select "C# / .NET" from the Driver selection menu and the version that best matches the version you installed from the Version selection menu.

Ensure the View full code sample option is deselected to view only the connection string.

Copy your connection string.

Click the button on the right of the connection string to copy it to your clipboard as shown in the following screenshot:

Update the password placeholder.

Paste this connection string into a file in your preferred text editor and replace the <db_password> placeholder with your database user's password. The connection string is already populated with your database user's username.

Save this file to a safe location for use in the next step.

Set an environment variable.

In your shell, run the following code to save your MongoDB connection string to an environment variable. Replace <your MongoDB URI> with the connection string that you saved to a file in the previous step.

export MONGODB_URI="<your MongoDB URI>"

set MONGODB_URI="<your MongoDB URI>"

Storing your credentials in an environment variable is safer than hardcoding them in your source code.

Create your .NET/C# application.

Copy and paste the following code into the Program.cs file in your application:

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/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 }));

Run your application.

In your shell, run the following command to start this application:

dotnet run csharp-quickstart.csproj

The output includes details of the retrieved movie document:

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