推荐使用官方驱动 MongoDB.Driver,它支持 .NET 5/6/7/8 和 .NET Framework 4.7.2+,安装后通过 MongoClient 建立连接、获取数据库和集合,支持异步增删改查及 BSON 映射。

用 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("people"); // 指定强类型
注意:
- 连接字符串支持用户名密码、副本集、SSL 等,例如:
mongodb://user:pass@localhost:27017/mydb?authSource=admin&ssl=true -
GetCollection中的T是你的实体类,需匹配 BSON 字段(或用[BsonElement]映射)
基本增删改查操作(异步推荐)
所有核心方法都提供 Async 版本,避免阻塞:
// 插入
await collection.InsertOneAsync(new Person { Name = "张三", Age = 25 });
// 查询单条
var person = await collection.Find(x => x.Name == "张三").FirstOrDefaultAsync();
// 查询多条(支持 LINQ)
var adults = await collection.Find(x => x.Age >= 18).ToListAsync();
// 更新(按条件)
await collection.UpdateOneAsync(
Builders.Filter.Eq(x => x.Name, "张三"),
Builders.Update.Set(x => x.Age, 26)
);
// 删除
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 很顺畅。官方驱动更新活跃,遇到问题优先查 官方文档。











