C# and .NET MongoDB Driver¶

On this page

The official MongoDB C#/.NET Driver provides asynchronous interaction with MongoDB. For the official MongoDB C#/.NET reference, see:

Driver Features¶

MongoDB Driver: An updated .NET driver offering a full asynchronous stack. For documentation on the update .NET driver, see MongoDB C#/.NET Driver documentation.
BSON Library: A standalone BSON library with a serialization infrastructure that you can use to build high-performance serializers. For documentation on the BSON library, see BSON Reference.
Core Library: A new core library upon which MongoDB .NET Driver is built. Users can use the new core library to build alternative or experimental high-level APIs. For documentation on the core library, see Driver Core

The recommended way to download the driver is to use nuget. For more information, see Getting Started.

If upgrading from an earlier version of the C#/.NET driver, see also What’s New.

The following compatibility table specifies the recommended version(s) of the MongoDB C#/.NET driver for use with a specific version of MongoDB.

The first column lists the driver version(s).

C#/.NET Driver Version	MongoDB 2.4	MongoDB 2.6	MongoDB 3.0	MongoDB 3.2	MongoDB 3.4
Version 2.3	✓	✓	✓	✓	✓
Version 2.2	✓	✓	✓	✓
Version 2.0	✓	✓	✓
Version 1.11	✓	✓	✓	✓
Version 1.10	✓	✓	✓

The driver does not support older versions of MongoDB.

The following compatibility table specifies the recommended version(s) of the MongoDB C#/.NET driver for use with a specific version of .NET.

The first column lists the driver version(s).

Driver Version	.NET 3.5	.NET 4.0	.NET 4.5	.NET Core
Version 2.3			✓	✓
Version 2.2			✓
Version 2.0			✓
Version 1.11	✓	✓	✓
Version 1.10	✓	✓	✓

The current version of the C# Driver has been built and tested using