- Getting Started
This quick-start privides just enough information to get you started using the .NET driver. Refer to the reference guide for more complete information.
.NET 4.5 or later is required to utilize the libraries. It has also been tested with Mono 3.10 on OS X.
As the Core CLR hasn’t shipped yet, we don’t yet have support for it. We run compatibility reports using the .NET Portability Analyzer to mitigate the need to make public API changes when we are ready to release compatible assemblies.
Nuget is the simplest way to get the driver. There are 4 packages available on nuget.
- MongoDB.Driver: The new driver. It is mostly free of any legacy code and should be used for all new projects. More documentation can be found in the reference guide.
- MongoDB.Driver.Core: The core of the driver and a dependency of MongoDB.Driver. You will probably not use this package directly. More documentation can be found in the reference guide.
- MongoDB.Bson: The BSON layer. It is a dependency of MongoDB.Driver.Core. It may be used by itself. More documentation can be found in the reference guide.
- mongocsharpdriver: The compatibility layer for those upgrading from our 1.x series. This should not be used for new projects. More information can be found in the 1.x documentation;
The assembly names mostly correlate strongly with the package names above. For new applications, you’ll add references to
MongoDB.Bson.dll. For those working with legacy applications, you’ll also want to add a reference to