学习mongodb,试着翻译写,英语能力有限,希望大家指正,不顺畅地方大家担待,会后续翻译后面内容;
开始认识C#驱动(官方)
简介
本介绍提供了足够的信息,让你开始使用C#的驱动程序。起步之后,你可以参考文档的其余部分,了解更多信息。
下载C#驱动
最简单的下载C#官方驱动的方式是通过Nuget,(当前version:1.8.2)
你也可以在此地址下载该驱动
https://github.com/mongodb/mongo-csharp-driver/releases
如果是下载的是.zip文件,只要简单的解压并放在任何一个位置即可,如果下载的是.msi文件,点击即可运行安装,该程序会把所有dlls安装到C:\ProgramFiles (x86)\MongoDB\CSharp Driver 1.x
具体的路径根据你的系统而定
添加dll引用
右键点击添加引用找到相应的dll添加到解决方案中,你需要添加以下dll的引用:
- MongoDB.Bson.dll
- MongoDB.Driver.dll
当然,你可以直接用NuGet直接添加C#驱动dll到你的解决方案中。
引入命名空间
至少你要引入以下命名空间
using MongoDB.Bson;
using MongoDB.Driver;
另外,你可能会经常引入下面一个或者多个命名空间
using MongoDB.Driver.Builders;
using MongoDB.Driver.GridFS;
using MongoDB.Driver.Linq;
在其他特殊的一些情况下,会要引入另外的一些命名空间
获取Client Object对象引用
最简单的获取client object引用的方式是通过国一个连接字符串
String connectionString = "mongodb://localhost";
MongoClient client = new MongoClient(connectionString);
你可以存储client object 在一个全局变量中,MongoClient是线程安全的。
获取Server Object对象引用
Server object对象通过client object对象来创建::
MongoServer server = client.GetServer();
获取数据库对象引用
通过server object对象获取数据库对象引用
var database = server.GetDatabase("test"); // test为adb名称
如果你使用的不值一个数据库,你可以通过GetDatabase获取任何一个数据库对象的引用
BsonDocument 对象模式vs自定义实体模式
有两种让你可以创建document方式:
- 使用 BsonDocument 对象
- 使用自定义的实体对象
如果数据很难或者很散很难定义成相关实体,你可以通过BsonDocument来操作。
由于使用自定义类比较方便,这个教程中将要使用这种方式,C#驱动程序可以让使用你提供了一下内容的自定义类
1.具有无参的构造函数
2.定义了可读写的属性
这些要求和.NET’s XmlSerializer.所要求的一样
另外,如果你的自定义类作为根文档,它必须包含一个id字段或者一个id属性,(但是需要时你可以重写他),一般id类型为ObjectId,但并未对其类型进行强制约束
请看下面类实体定义:
public class Entity
{
public ObjectId Id { get; set; } public string Name { get; set; } }
获取集合对象引用
你可以通过如下方式获取集合对象
// "entities" 为集合名称 var collection = database.GetCollection<Entity>("entities");
插入文档对象
插入一个实体对象:
var entity = new Entity { Name = "Tom" }; collection.Insert(entity); var id = entity.Id; // insert时候会对id进行赋值
查询文档对象
在这个例子中假设知道id的值,我们将读取这个实体对象的值
var query = Query<Entity>.EQ(e => e.Id, id); var entity = collection.FindOne(query);
Query<Entity>.EQ 使用Query泛型类创建query对象,lambda表达式e => e.Id 指向到我们集合中定义的字段
说明:
一般说来,数据库中字段是和自定义实体中字段完全一样的,但是id是一个例外,他会映射到数据库中_id字段
其他查询操作
包括: GT, 大于
GTE,大于等于
In, LT, LTE, Near, NE, And, Or还有一些其他的
保存文档对象
你可以像这样保存一个文档:
entity.Name = "Dick"; collection.Save(entity);
更新文档对象
保存的另一个方式就是更新,不同之处在于保存会发送整个对象到服务器,更新只会发送对象改变的部分,例如:
var query = Query<Entity>.EQ(e => e.Id, id); var update = Update<Entity>.Set(e => e.Name, "Harry"); //更新 collection.Update(query, update);
通过update方法方便的进行更新操作
移除文档对象
你可以通过下面的方式移除文档对象
var query = Query<Entity>.EQ(e => e.Id, id); collection.Remove(query);
你无需调用Connect 或者Disconnect
C#的驱动程序都有一个连接池,有效地使用连接到服务器。所以无需调用Connect 或者Disconnect;只要交给驱动处理即可(调用Connect 没什么影响,但是调用Disconnect 会关掉连接池所有连接)
完整实例
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using MongoDB.Bson;
using MongoDB.Driver;
using MongoDB.Driver.Builders; namespace ConsoleApplication1
{ public class Entity
{ public ObjectId Id { get; set; } public string Name { get; set; }
} class Program
{
static void Main(string[] args)
{ var connectionString = "mongodb://localhost"; var client = new MongoClient(connectionString); var server = client.GetServer(); var database = server.GetDatabase("test"); var collection = database.GetCollection<Entity>("entities"); var entity = new Entity { Name = "Tom" };
collection.Insert(entity);
var id = entity.Id; var query = Query<Entity>.EQ(e => e.Id, id);
entity = collection.FindOne(query); entity.Name = "Dick"; collection.Save(entity); var update = Update<Entity>.Set(e => e.Name, "Harry"); collection.Update(query, update); collection.Remove(query); }
}
}