在.Net Core中使用MongoDB的入门教程(一)
首先,我们在MongoDB的官方文档中看到,MongoDb的2.4以上的For .Net的驱动是支持.Net Core 2.0的。
所以,在我们安装好了MangoDB后,就可以开始MangoDB的.Net之旅了。
首先,创建一个.Net Core的控制台应用程序。然后使用NuGet导入MangoDB的驱动程序。
在官方文档上有介绍,在NuGet中移动有五个.Net 的驱动版本。
Nuget是获取驱动程序最简单的方法。在nuget上有5个软件包可用。
MongoDB.Driver:新的驱动程序。它几乎没有任何遗留代码,应该用于所有新项目。更多文档可以在参考指南中找到。
MongoDB.Driver.Core:驱动程序的核心和MongoDB.Driver的依赖。你可能不会直接使用这个包。更多文档可以在参考指南中找到。
MongoDB.Driver.GridFS:GridFS包。更多文档可以在参考指南中找到。
MongoDB.Bson:BSON层。它是MongoDB.Driver.Core的依赖。它可以被自己使用。更多文档可以在参考指南中找到。
mongocsharpdriver:从1.x系列升级的兼容层。这不应该用于新项目。更多信息可以在1.x文档中找到。
也可以在github版本库的release中下载ZIP文件,通过引用DLL文件,实现驱动安装。
需要添加MongoDB.Driver.dll,MongoDB.Driver.Core.dll和MongoDB.Bson.dll三个文件的引用。
不过,我还是推荐使用Nuget直接安装MongoDB.Driver。
安装好驱动后,我们就可以开始撸代码了。
1.建立数据库连接。
// 使用连接字符串连接 var client = new MongoClient("mongodb://localhost:27017"); // 制定多个地址和端口,让程序自动选择一个进行连接。 var client = new MongoClient("mongodb://localhost:27017,localhost:27018,localhost:27019");
2.获取数据库
为了得到一个数据库,我们可以使用client的GetDatabase方法获取数据库,即使数据库不存在,也没有关系,它会在首次使用数据库的时候进行自动创建。
var database = client.GetDatabase("foo");
3.获取数据集Collection
我们可以调用database的GetCollection<TDocument>方法来获取数据集,其中如果数据是预先定义好的可以在<输入数据的类型> ,如果是没有定义好的,可以使用BsonDocument类型,BsonDocument表示没有预定于的模式。
var collection = database.GetCollection<BsonDocument>("bar");
此时,我们将获取到“foo”数据库中的“bar”集合,即使“bar”集合不存在也没有关系,同数据库一样,若数据集不存在,会自动创建该数据集。
4.插入数据
获得了collection数据集后,就可以往数据集中插入数据了,如果我们需要在数据集中插入如下一段JSON文件
{ "name": "MongoDB", "type": "database", "count": 1, "info": { x: 203, y: 102 } }
那么我们可以使用BsonDocument来创建一个这样的数据类型来表示该Json数据。
var document = new BsonDocument { { "name", "MongoDB" }, { "type", "Database" }, { "count", 1 }, { "info", new BsonDocument { { "x", 203 }, { "y", 102 } }} };要将该document插入到collection中,我们可以使用InsertOne(同步插入)或InsertOneAsync(异步插入)方法。
InsertOne(同步插入):
collection.InsertOne(document);InsertOneAsync(异步插入):
await collection.InsertOneAsync(document);
5.插入多条数据
以上说到了插入单个数据的方法,如果想要插入多个数据,可以使用InsertMany
or InsertManyAsync
方法。
先使用计算器产生100条BsonDocument数据。
var documents = Enumerable.Range(0, 100).Select(i => new BsonDocument("counter", i));
InsertMany(同步插入:)
collection.InsertMany(documents);
InsertManyAsync(异步插入:)
await collection.InsertManyAsync(documents);
6,查询插入文件个数
在上面的两个例子中,我们一共插入了101条数据。我们可以使用以下方法,获取插入的BsonDocument类型数据的条数。
同步获取:
var count = collection.Count(new BsonDocument()); //产生一个空BsonDocument的过滤器,指对该类型的文档进行计数。异步获取:
var count = await collection.CountAsync(new BsonDocument()); //产生一个空BsonDocument的过滤器,指对该类型的文档进行计数。
好了,今天数据的插入线介绍到这里,在我下面的博客中,我会对.Net Core中使用MangoDB进行系统记录,欢迎大家长期关注。
教程2已更新