MongoDB.Driver 3.1.0

Prefix Reserved
dotnet add package MongoDB.Driver --version 3.1.0                
NuGet\Install-Package MongoDB.Driver -Version 3.1.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MongoDB.Driver" Version="3.1.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MongoDB.Driver --version 3.1.0                
#r "nuget: MongoDB.Driver, 3.1.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install MongoDB.Driver as a Cake Addin
#addin nuget:?package=MongoDB.Driver&version=3.1.0

// Install MongoDB.Driver as a Cake Tool
#tool nuget:?package=MongoDB.Driver&version=3.1.0                

MongoDB C# Driver

You can get the latest stable release from the official Nuget.org feed or from our github releases page.

Getting Started

Untyped Documents

using MongoDB.Bson;
using MongoDB.Driver;
var client = new MongoClient("mongodb://localhost:27017");
var database = client.GetDatabase("foo");
var collection = database.GetCollection<BsonDocument>("bar");

await collection.InsertOneAsync(new BsonDocument("Name", "Jack"));

var list = await collection.Find(new BsonDocument("Name", "Jack"))
    .ToListAsync();

foreach(var document in list)
{
    Console.WriteLine(document["Name"]);
}

Typed Documents

using MongoDB.Bson;
using MongoDB.Driver;
public class Person
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
}
var client = new MongoClient("mongodb://localhost:27017");
var database = client.GetDatabase("foo");
var collection = database.GetCollection<Person>("bar");

await collection.InsertOneAsync(new Person { Name = "Jack" });

var list = await collection.Find(x => x.Name == "Jack")
    .ToListAsync();

foreach(var person in list)
{
    Console.WriteLine(person.Name);
}

Documentation

Questions/Bug Reports

If you’ve identified a security vulnerability in a driver or any other MongoDB project, please report it according to the instructions here.

Contributing

Please see our guidelines for contributing to the driver.

Thank you to everyone who has contributed to this project.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2.7K)

Showing the top 5 NuGet packages that depend on MongoDB.Driver:

Package Downloads
AspNetCore.HealthChecks.MongoDb

HealthChecks.MongoDb is the health check package for MongoDb.

MongoDB.Driver.GridFS

GridFS Component of the Official MongoDB .NET Driver.

mongocsharpdriver

This package contains the legacy driver. The new driver's package name is MongoDB.Driver

Mongo2Go

Mongo2Go is a managed wrapper around MongoDB binaries. It targets .NET Framework 4.7.2 and .NET Standard 2.1. This Nuget package contains the executables of mongod, mongoimport and mongoexport v4.4.4 for Windows, Linux and macOS. Mongo2Go has two use cases: 1. Providing multiple, temporary and isolated MongoDB databases for integration tests 2. Providing a quick to set up MongoDB database for a local developer environment

MongoDB.Driver.Core.Extensions.DiagnosticSources

Package Description

GitHub repositories (194)

Showing the top 5 popular GitHub repositories that depend on MongoDB.Driver:

Repository Stars
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
MassTransit/MassTransit
Distributed Application Framework for .NET
dotnetcore/CAP
Distributed transaction solution in micro-service base on eventually consistency, also an eventbus with Outbox pattern
Version Downloads Last updated
3.1.0 124,326 12/5/2024
3.0.0 870,410 10/16/2024
2.30.0 666,678 10/16/2024
2.29.0 1,042,066 9/18/2024
2.28.0 3,768,400 7/23/2024
2.27.0 1,997,834 6/28/2024
2.26.0 916,891 6/12/2024
2.25.0 3,894,632 4/12/2024
2.24.0 3,387,584 2/21/2024
2.23.2 128,379 2/20/2024
2.23.1 4,914,847 12/15/2023
2.23.0 516,631 12/11/2023
2.22.0 6,616,389 10/9/2023
2.21.0 4,280,301 8/10/2023
2.20.0 4,875,901 6/21/2023
2.19.2 2,728,926 5/25/2023
2.19.1 6,639,381 3/27/2023
2.19.0 7,592,652 1/27/2023
2.18.0 8,961,870 10/14/2022 2.18.0 has at least one vulnerability with high severity.
2.17.1 9,906,835 7/30/2022 2.17.1 has at least one vulnerability with high severity.
2.17.0 1,199,215 7/18/2022 2.17.0 has at least one vulnerability with high severity.
2.16.1 2,163,556 6/21/2022 2.16.1 has at least one vulnerability with high severity.
2.16.0 1,277,158 6/7/2022 2.16.0 has at least one vulnerability with high severity.
2.15.1 3,740,400 5/4/2022 2.15.1 has at least one vulnerability with high severity.
2.15.0 4,475,630 3/9/2022 2.15.0 has at least one vulnerability with high severity.
2.14.1 12,652,019 12/3/2021 2.14.1 has at least one vulnerability with high severity.
2.14.0 1,367,356 11/24/2021 2.14.0 has at least one vulnerability with high severity.
2.14.0-beta1 56,412 10/15/2021 2.14.0-beta1 has at least one vulnerability with high severity.
2.13.3 1,071,123 11/23/2021 2.13.3 has at least one vulnerability with high severity.
2.13.2 8,481,894 10/6/2021 2.13.2 has at least one vulnerability with high severity.
2.13.1 6,135,663 8/4/2021 2.13.1 has at least one vulnerability with high severity.
2.13.0 1,564,756 7/13/2021 2.13.0 has at least one vulnerability with high severity.
2.13.0-beta1 60,985 3/31/2021 2.13.0-beta1 has at least one vulnerability with high severity.
2.12.5 101,849 11/20/2021 2.12.5 has at least one vulnerability with high severity.
2.12.4 2,816,161 6/4/2021 2.12.4 has at least one vulnerability with high severity.
2.12.3 2,445,757 5/4/2021 2.12.3 has at least one vulnerability with high severity.
2.12.2 2,355,989 4/7/2021 2.12.2 has at least one vulnerability with high severity.
2.12.1 1,329,231 3/23/2021 2.12.1 has at least one vulnerability with high severity.
2.12.0 4,638,638 3/3/2021 2.12.0 has at least one vulnerability with high severity.
2.12.0-beta1 129,420 11/6/2020 2.12.0-beta1 has at least one vulnerability with high severity.
2.11.6 9,223,590 1/20/2021 2.11.6 has at least one vulnerability with high severity.
2.11.5 3,587,263 12/2/2020 2.11.5 has at least one vulnerability with high severity.
2.11.4 2,257,669 11/4/2020 2.11.4 has at least one vulnerability with high severity.
2.11.3 2,821,083 10/15/2020 2.11.3 has at least one vulnerability with high severity.
2.11.2 6,296,503 9/10/2020 2.11.2 has at least one vulnerability with high severity.
2.11.1 1,149,536 8/25/2020 2.11.1 has at least one vulnerability with high severity.
2.11.0 2,016,380 7/30/2020 2.11.0 has at least one vulnerability with high severity.
2.11.0-beta2 25,513 6/10/2020 2.11.0-beta2 has at least one vulnerability with high severity.
2.11.0-beta1 56,431 4/10/2020 2.11.0-beta1 has at least one vulnerability with high severity.
2.10.4 8,605,313 5/5/2020 2.10.4 has at least one vulnerability with high severity.
2.10.3 1,860,136 4/7/2020 2.10.3 has at least one vulnerability with high severity.
2.10.2 5,606,572 2/14/2020 2.10.2 has at least one vulnerability with high severity.
2.10.1 3,165,172 1/15/2020 2.10.1 has at least one vulnerability with high severity.
2.10.0 6,519,727 12/10/2019 2.10.0 has at least one vulnerability with high severity.
2.10.0-beta1 46,074 10/2/2019 2.10.0-beta1 has at least one vulnerability with high severity.
2.9.3 3,436,911 11/8/2019 2.9.3 has at least one vulnerability with high severity.
2.9.2 3,941,414 9/30/2019 2.9.2 has at least one vulnerability with high severity.
2.9.1 7,099,864 8/21/2019 2.9.1 has at least one vulnerability with high severity.
2.9.0 343,722 8/15/2019 2.9.0 has at least one vulnerability with high severity.
2.9.0-beta2 40,279 6/17/2019 2.9.0-beta2 has at least one vulnerability with high severity.
2.9.0-beta1 50,683 3/13/2019 2.9.0-beta1 has at least one vulnerability with high severity.
2.8.1 6,671,540 5/15/2019 2.8.1 has at least one vulnerability with high severity.
2.8.0 4,768,053 3/13/2019 2.8.0 has at least one vulnerability with high severity.
2.7.3 2,701,310 1/24/2019 2.7.3 has at least one vulnerability with high severity.
2.7.2 4,629,293 11/10/2018 2.7.2 has at least one vulnerability with high severity.
2.7.1 48,573 11/8/2018 2.7.1 has at least one vulnerability with high severity.
2.7.0 6,438,952 6/27/2018 2.7.0 has at least one vulnerability with high severity.
2.7.0-beta0001 35,393 4/22/2018 2.7.0-beta0001 has at least one vulnerability with high severity.
2.6.1 1,319,467 5/17/2018 2.6.1 has at least one vulnerability with high severity.
2.6.0 750,773 4/24/2018 2.6.0 has at least one vulnerability with high severity.
2.5.1 713,284 4/19/2018 2.5.1 has at least one vulnerability with high severity.
2.5.0 3,390,673 12/12/2017 2.5.0 has at least one vulnerability with high severity.
2.4.4 3,507,819 6/8/2017 2.4.4 has at least one vulnerability with high severity.
2.4.3 1,280,111 3/9/2017 2.4.3 has at least one vulnerability with high severity.
2.4.2 403,583 2/2/2017 2.4.2 has at least one vulnerability with high severity.
2.4.1 193,148 1/4/2017 2.4.1 has at least one vulnerability with high severity.
2.4.0 644,322 11/29/2016 2.4.0 has at least one vulnerability with high severity.
2.4.0-beta1 19,611 10/5/2016 2.4.0-beta1 has at least one vulnerability with high severity.
2.3.0 4,793,978 9/23/2016 2.3.0 has at least one vulnerability with high severity.
2.3.0-rc1 87,400 8/29/2016 2.3.0-rc1 has at least one vulnerability with high severity.
2.3.0-beta1 11,593 8/3/2016 2.3.0-beta1 has at least one vulnerability with high severity.
2.2.4 860,183 5/18/2016 2.2.4 has at least one vulnerability with high severity.
2.2.3 537,628 2/2/2016 2.2.3 has at least one vulnerability with high severity.
2.2.2 60,518 1/15/2016 2.2.2 has at least one vulnerability with high severity.
2.2.1 24,597 1/8/2016 2.2.1 has at least one vulnerability with high severity.
2.2.0 152,894 12/7/2015 2.2.0 has at least one vulnerability with high severity.
2.2.0-rc0 4,894 11/18/2015 2.2.0-rc0 has at least one vulnerability with high severity.
2.1.1 179,815 11/11/2015 2.1.1 has at least one vulnerability with high severity.
2.1.0 95,768 10/19/2015 2.1.0 has at least one vulnerability with high severity.
2.1.0-rc1 8,839 10/7/2015 2.1.0-rc1 has at least one vulnerability with high severity.
2.1.0-rc0 6,550 9/17/2015 2.1.0-rc0 has at least one vulnerability with high severity.
2.0.2 62,458 11/11/2015 2.0.2 has at least one vulnerability with high severity.
2.0.1 371,878 6/8/2015 2.0.1 has at least one vulnerability with high severity.
2.0.0 406,804 4/2/2015 2.0.0 has at least one vulnerability with high severity.
2.0.0-rc0 16,703 3/17/2015 2.0.0-rc0 has at least one vulnerability with high severity.
2.0.0-beta4 3,246 3/9/2015 2.0.0-beta4 has at least one vulnerability with high severity.
2.0.0-beta3 2,826 3/5/2015 2.0.0-beta3 has at least one vulnerability with high severity.
2.0.0-beta2 3,975 2/4/2015 2.0.0-beta2 has at least one vulnerability with high severity.
2.0.0-beta1 4,026 1/16/2015 2.0.0-beta1 has at least one vulnerability with high severity.