README.md

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 [email protected]
• Craig Wilson [email protected]

Contributors (in alphabetical order):

• Bit Diffusion Limited [email protected]
• Alex Brown https://github.com/alexjamesbrown
• Justin Dearing [email protected]
• Dan DeBilt [email protected]
• Teun Duynstee [email protected]
• Einar Egilsson https://github.com/einaregilsson
• Ken Egozi [email protected]
• Daniel Goldman [email protected]
• Simon Green [email protected]
• Nik Kolev [email protected]
• Oleg Kosmakov [email protected]
• Brian Knight [email protected]
• Richard Kreuter [email protected]
• Kevin Lewis [email protected]
• Dow Liu [email protected]
• Alex Lyman [email protected]
• Alexander Nagy [email protected]
• Sridhar Nanjundeswaran https://github.com/sridharn
• Andrew Rondeau [email protected]
• Ed Rooth [email protected]
• Pete Smith [email protected]
• staywellandy https://github.com/staywellandy
• Testo [email protected]
• 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).