Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 62 lines (52 sloc) 2.433 kb
d55dbc1 @samus Initial release on GitHub
authored
1 MongoDB-CSharp
2 ==============
47b7192 @samus Moved AddUser to the DatabaseMetaData class
authored
3 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.
d55dbc1 @samus Initial release on GitHub
authored
4
5 Current Features
6 ================
7 - Connect to a server.
8 - Query
9 - Insert
10 - Update
11 - Delete
cdef7f0 @samus Added Database.FollowReference to dereference a DBRef.cs
authored
12 - Most BSON types supported
13 - DBRef support
d55dbc1 @samus Initial release on GitHub
authored
14 - Isolation and conversion between BSON types and native .net types.
15 - Database, Collection and Cursor objects.
0bbb2cc Removed an unnecesary file.
Samuel Corder authored
16 - Index handling routines (List, Create, Drop)
cdef7f0 @samus Added Database.FollowReference to dereference a DBRef.cs
authored
17 - Count
18 - Roughly 80% unit test coverage. This can and will be improved on.
47b7192 @samus Moved AddUser to the DatabaseMetaData class
authored
19 - Paired connections
20 - Authentication (Does not reauthorize on auto reconnect yet).
d55dbc1 @samus Initial release on GitHub
authored
21
22 Missing Features
23 ================
24 - Auto reconnect options
47b7192 @samus Moved AddUser to the DatabaseMetaData class
authored
25 - Connection pooling (maybe not implemented)
cdef7f0 @samus Added Database.FollowReference to dereference a DBRef.cs
authored
26 - A few BSON Types (easy to add)
d55dbc1 @samus Initial release on GitHub
authored
27 - Database commands (can send queries to $cmd if necessary)
47b7192 @samus Moved AddUser to the DatabaseMetaData class
authored
28 - Exceptions (In progress)
cdef7f0 @samus Added Database.FollowReference to dereference a DBRef.cs
authored
29 - hint, explain, $where
d55dbc1 @samus Initial release on GitHub
authored
30 - database profiling: set/get profiling level, get profiling info
31 - GridFS support
32 - Many unit tests
33
34 Installation
35 ============
36 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.
37
38 Patches
39 =======
40 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.
cdef7f0 @samus Added Database.FollowReference to dereference a DBRef.cs
authored
41
42 Usage
43 =====
44 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.
45
46 At the simplest query the database like this:
47 using MongoDB.Driver;
48 Mongo db = new Mongo();
49 db.Connect(); //Connect to localhost on the default port.
50 Document query = new Document();
51 query["field1"] = 10;
52 Document result = db["tests"]["reads"].FindOne(query);
53 db.Disconnect();
54
fcd14c9 @samus Changed Collection.Insert to take an IEnumerable<Document> to provide mo...
authored
55 Contributors
56 ============
06e5fc2 @samus Merged authentication code from Seth Edwards
authored
57 - Sam Corder (samus)
58 - Seth Edwards (Sedward)
59 - Sergey Bartunov (sbos)
fcd14c9 @samus Changed Collection.Insert to take an IEnumerable<Document> to provide mo...
authored
60
cdef7f0 @samus Added Database.FollowReference to dereference a DBRef.cs
authored
61
Something went wrong with that request. Please try again.