bursauxa / mongo-csharp-driver

.NET Driver for MongoDB

MongoDB C# Driver

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

If you'd like to work with the bleeding edge, you can use our custom feed. Some packages on this feed are pre-release and, while they've passed all our tests, are not yet ready for production.

Build Status

.NET:

Mono:

Getting Started

Untyped Documents

using MongoDB.Bson;
using MongoDB.Driver;

var client = new MongoClient("mongodb://localhost:27017");
var database = client.GetDatabase("foo");
var collection = client.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

• MongoDB
• Documentation

Questions/Bug Reports

• Discussion Forum
• Stack Overflow
• Jira

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.

Maintainers:

• Robert Stam [e-mail]
• Craig Wilson [e-mail]

Contributors (in alphabetical order):

• Bit Diffusion Limited [e-mail]
• Alex Brown https://github.com/alexjamesbrown
• Justin Dearing [e-mail]
• Dan DeBilt [e-mail]
• Teun Duynstee [e-mail]
• Einar Egilsson https://github.com/einaregilsson
• Ken Egozi [e-mail]
• Daniel Goldman [e-mail]
• Simon Green [e-mail]
• Nik Kolev [e-mail]
• Oleg Kosmakov [e-mail]
• Brian Knight [e-mail]
• Richard Kreuter [e-mail]
• Kevin Lewis [e-mail]
• Dow Liu [e-mail]
• Alex Lyman [e-mail]
• Alexander Nagy [e-mail]
• Sridhar Nanjundeswaran https://github.com/sridharn
• Andrew Rondeau [e-mail]
• Ed Rooth [e-mail]
• Pete Smith [e-mail]
• staywellandy https://github.com/staywellandy
• Testo [e-mail]
• Bar Arnon https://github.com/I3arnon

If you have contributed and we have neglected to add you to this list please contact one of the maintainers to be added to the list (with apologies).