MongoDB的C#驱动基本使用

MongoDB的官方C#驱动可以通过这个链接得到。链接提供了.msi和.zip两种方式获取驱动dll文件。

通过这篇文章来介绍C#驱动的基本数据库连接,增删改查操作。

在使用C#驱动的时候,要在工程中添加"MongoDB.Bson.dll"和"MongoDB.Driver.dll"的引用。同时要在代码中加入下面两个using语句。

using MongoDB.Bson; using MongoDB.Driver; 

数据库连接

要建立数据库连接,就一定要知道服务器的地址、端口等信息。所有的这些信息,我们都使用连接字符串表示。MongoDB的连接字符串格式如下:

mongodb://[username:password@]host1[:port1][,host2[:port2],…[,hostN[:portN]]][/[database][?options]]

下面看看连接字符串中的各个字段的含义:

mongodb://:这个是MongoDB连接字符串的前缀

username:password(Optional):可选项,表示登录用户名和密码,用于完成用户安全验证

hostN: 必须的指定至少一个host,表示连接到的MongoDB实例

portN(Optional):可选项,默认连接到27017

database(Optional):如果指定username:password@,连接并验证登陆指定数据库。若不指定,默认打开admin数据库。

options(Optional):可选项,如果不使用/database,则前面需要加上/。所有连接选项都是键值对name=value,键值对之间通过&或;(分号)隔开

在这里,使用文章"MongoDB管理"中的例子,test1和test2有各自的用户。当使用下面的连接字符串访问的时候,可以得到正确的验证,因为"Will1:Will1"对test1有读写权限。如果换成访问test2数据库,则会得到一个"Invalid credentials for database 'test2'"的异常输出。

string connectionStr = "mongodb://Will1:Will1@localhost"; MongoClient client = new MongoClient(connectionStr); MongoServer server = client.GetServer(); MongoDatabase db = server.GetDatabase("test2"); MongoCollection<BsonDocument> collection = db.GetCollection("student"); try { Console.WriteLine("db name is: " + db.Name); Console.WriteLine("collections name is: " + collection.Name); Console.WriteLine("{0} items in this collection", collection.Count()); } catch (Exception e) { Console.WriteLine(e.Message); }

从上面的代码中可以看到:

如何获取client和server对象

string connectionStr = "mongodb://Will1:Will1@localhost"; MongoClient client = new MongoClient(connectionStr); MongoServer server = client.GetServer();

如何获得数据库和collection对象

MongoDatabase db = server.GetDatabase("test2"); MongoCollection<BsonDocument> collection = db.GetCollection("student"); 

BsonDocument对象模型

在开始增删改查的介绍之前,要介绍一下BsonDocument对象模型。

在MongoDB collection中,每个文档都可以看作一个Bson(Binary JSON)对象,所以在驱动中有个一个BsonDocument类型,可以通过下面的方式生成一个文档,并且通过Add方法添加键/值对。通过这种方式生成的BsonDocument对象可以直接插入collection中。

BsonDocument student1 = new BsonDocument(); student1.Add("sid", 10); student1.Add("name", "Will10"); student1.Add("gender", "Male"); student1.Add("age", 26);

在MongoDB中,当用户对collection进行操作的时候可以有两种方式:

通过BsonDocument对象模型

通过自定义类型

上面已经介绍过了BsonDocument对象,在这里我们也可以使用自己自定义的类型。比如,我们可以定义一个Student类型,将该类型的对象插入到collection中。

public class Student { public ObjectId _id; public int sid; public string name; public string gender; public int age; }

注意:当是用自定义类型的时候一定要有Id字段。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/2f3637a1728c8c223c12112ff7b39b8f.html