MongoDB C#/.NET Driver¶
Introduction¶
The official MongoDB C#/.NET Driver provides asynchronous interaction with MongoDB.
Take the free online course taught by MongoDB¶
 |
|
Installation¶
NuGet is the simplest way to get the driver. Use
MongoDB.Driver for
all new projects.
For more information, see Installation.
Connect to MongoDB Atlas¶
To connect to a MongoDB Atlas cluster, use the Atlas connection string for your cluster:
using MongoDB.Bson; using MongoDB.Driver; // ... var client = new MongoClient( "mongodb+srv://<username>:<password>@<cluster-address>/test?w=majority" ); var database = client.GetDatabase("test");
See Connecting for more information.
Compatibility¶
MongoDB Compatibility¶
C#/.NET Driver Version | MongoDB 4.4 | MongoDB 4.2 | MongoDB 4.0 | MongoDB 3.6 | MongoDB 3.4 | MongoDB 3.2 | MongoDB 3.0 | MongoDB 2.6 |
|---|---|---|---|---|---|---|---|---|
2.12 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.11 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.10 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
2.9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |
2.8 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
2.7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
2.6 | ✓ | ✓ | ✓ | ✓ | ✓ | |||
2.5 | ✓ | ✓ | ✓ | ✓ | ✓ | |||
2.4 | ✓ | ✓ | ✓ | ✓ | ||||
2.3 | ✓ | ✓ | ✓ | |||||
2.2 | ✓ | ✓ | ✓ | |||||
2.0 | ✓ | ✓ | ||||||
1.11 | ✓ | ✓ | ✓ | |||||
1.10 | ✓ | ✓ |
The driver does not support older versions of MongoDB.
Language Compatibility¶
C#/.NET Driver Version | .NET 5 [1] | .NET Core 3.1 | .NET Core 3.0 | .NET Core 2.2 | .NET Core 2.1 | .NET Core 2.0 | .NET Core 1.1 | .NET Core 1.0 | .NET 4.8 | .NET 4.7 | .NET 4.6 | .NET 4.5 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
2.12 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.11 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.10 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.9 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.8 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.7 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.6 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.5 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.4 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.3 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
2.2 | ✓ | ✓ | ✓ | ✓ | ||||||||
2.0 | ✓ | ✓ | ✓ | ✓ |
Versions 1.10 and 1.11 of the driver are compatible with .NET 3.5 through 4.8 only.
| [1] | When using .NET 5, you can't connect to Atlas clusters running MongoDB 4.0 due to a certificate issue. |
For more information on how to read the compatibility tables, see our guide on MongoDB Compatibility Tables.
Visual Studio Compatibility¶
If your Visual Studio IDE project depends on the official Mongo C# driver version 2.10 or later, you must use Visual Studio 2017 or later.
How to get help¶
- Ask questions on our MongoDB Community Forums.
- Visit our Support Channels.
- See the project JIRA to raise issues or request features.
Give Feedback