C#怎么连接MongoDB数据库 C# MongoDB官方驱动使用方法

来源:这里教程网 时间:2026-02-21 17:37:14 作者:

用 C# 连接 MongoDB,推荐直接使用官方驱动 MongoDB.Driver(.NET 版),它支持 .NET 5/6/7/8 和 .NET Framework 4.7.2+,封装完善、异步友好、文档齐全。

安装官方驱动包

在项目中通过 NuGet 安装核心包:

MongoDB.Driver:主驱动(含同步/异步 API、LINQ 支持、连接池等) (可选)MongoDB.Bson:BSON 类型基础库(Driver 已自动依赖,一般无需单独装)

命令行安装:

dotnet add package MongoDB.Driver

建立连接并获取数据库/集合

使用

MongoClient
管理连接(线程安全,建议全局单例复用):

var connectionString = "mongodb://localhost:27017";
var client = new MongoClient(connectionString); // 自动复用连接池
var database = client.GetDatabase("mydb");
var collection = database.GetCollection<Person>("people"); // 指定强类型

注意:

连接字符串支持用户名密码、副本集、SSL 等,例如:
mongodb://user:pass@localhost:27017/mydb?authSource=admin&ssl=true
GetCollection<t></t>
中的
T
是你的实体类,需匹配 BSON 字段(或用
[BsonElement]
映射)

基本增删改查操作(异步推荐)

所有核心方法都提供

Async
版本,避免阻塞:

// 插入
await collection.InsertOneAsync(new Person { Name = "张三", Age = 25 });
<p>// 查询单条
var person = await collection.Find(x => x.Name == "张三").FirstOrDefaultAsync();</p><p>// 查询多条(支持 LINQ)
var adults = await collection.Find(x => x.Age >= 18).ToListAsync();</p><p>// 更新(按条件)
await collection.UpdateOneAsync(
Builders<Person>.Filter.Eq(x => x.Name, "张三"),
Builders<Person>.Update.Set(x => x.Age, 26)
);</p><p>// 删除
await collection.DeleteManyAsync(x => x.Age < 18);

实体类与 BSON 映射要点

定义 POCO 类时注意默认行为:

ID 字段建议命名为
Id
ObjectId
string
类型),驱动会自动映射为
_id
如字段名不一致,用特性标注:
[BsonElement("user_name")] public string UserName { get; set; }
忽略字段:
[BsonIgnore] public string TempFlag { get; set; }
自定义 ObjectId 生成(如用字符串 ID):
[BsonId][BsonRepresentation(BsonType.ObjectId)] public string Id { get; set; }

基本上就这些。只要连接串正确、实体对齐、用好异步 API,C# 操作 MongoDB 很顺畅。官方驱动更新活跃,遇到问题优先查 官方文档。

相关推荐