Skip to content

A driver written in c# to connect to the MongoDB document oriented database.

License

Notifications You must be signed in to change notification settings

ensecoz/mongodb-csharp

 
 

Repository files navigation

MongoDB-CSharp

This is a community supported release of a driver to connect to MongoDB using .Net. It is written entirely in C# and has been tested and developed under both Windows and Mono 2.0 (Ubuntu 32-bit 9.04). Currently many features have been implemented with a few remaining. The api is very likely to change and be in flux for a while but is quickly settling down. At this point it is becoming a solid base to add many more advanced features.

Current Features

  • Connect to a server.
  • Query
  • Insert
  • Update
  • Delete
  • All BSON types supported
  • DBRef support
  • Isolation and conversion between BSON types and native .net types.
  • Database, Collection and Cursor objects.
  • Index handling routines (List, Create, Drop)
  • Count
  • Roughly 80% unit test coverage. This can and will be improved on.
  • Paired connections
  • Authentication (Does not reauthorize on auto reconnect yet).
  • Database Commands
  • Basic Linq support
  • GridFS support
  • Map Reduce helpers.
  • hint, explain, $where
  • Safemode
  • Exceptions

Missing Features

  • Auto reconnect options
  • Connection pooling (In progress)
  • database profiling: set/get profiling level, get profiling info
  • Many unit tests

Installation

Currently using the driver in the GAC is not supported. Simply copy the driver assembly somewhere and reference it in your project. It should be deployed in your application's bin directory. It is not necessary to use the test assembly.

Patches

Patches are welcome and will likely be accepted. By submitting a patch you assign the copyright to me, Sam Corder. This is necessary to simplify the number of copyright holders should it become necessary that the copyright need to be reassigned or the code relicensed. The code will always be available under an OSI approved license.

Usage

One of the best sources for how to use the driver is the unit tests. Basic usage can be found in the TestCollection set of test cases.

At the simplest query the database like this:
using MongoDB.Driver; Mongo db = new Mongo(); db.Connect(); //Connect to localhost on the default port. Document query = new Document(); query["field1"] = 10; Document result = db["tests"]["reads"].FindOne(query); db.Disconnect();

Getting Help

The Google Group mongodb-csharp at (http://groups.google.com/group/mongodb-csharp) is the best place to go.

Contributors

  • Sam Corder (samus)
  • Seth Edwards (Sedward)
  • Arne Classen (Sdether)
  • Steve Wagner (lanwin)
  • Andrew Rondeau (GWBasic)
  • Andrew Kempe
  • Sergey Bartunov (sbos)

About

A driver written in c# to connect to the MongoDB document oriented database.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%