MongoDB .NET Driver投影字段别名设置及.NET 8 Blazor C#实现

1. 调整投影代码实现字段别名 #

你原来用Include的方式没法直接设置别名，要改用Projection.Add方法指定字段映射，把NameField重命名为Name，同时保留_id字段。代码示例：

var project = Builders<BsonDocument>.Projection
    .Add("Name", "$NameField") // 第一个参数是别名，第二个参数是带$前缀的原字段名
    .Include("_id");

注意：原字段名必须加$前缀，这是MongoDB识别字段引用的规则。

2. 在查询流程中应用投影 #

把构建好的投影对象通过Project()方法附加到查询语句后，再执行查询即可。完整整合代码如下：

var client = new MongoClient();
var db = client.GetDatabase("DB");
var coll = db.GetCollection<BsonDocument>("CollectionName");
var filter = Builders<BsonDocument>.Filter.Eq("_id", id);

// 构建带别名的投影
var project = Builders<BsonDocument>.Projection
    .Add("Name", "$NameField")
    .Include("_id");

// Blazor推荐异步调用获取结果
var result = await coll.Find(filter).Project(project).FirstOrDefaultAsync();

如果是同步场景，也可以用.Result获取结果，但异步方式更适配Blazor组件生命周期。

额外实用建议 #

• 若不需要返回_id字段，把.Include("_id")换成.Exclude("_id")即可（MongoDB默认会返回_id，需显式声明排除）。
• 如果你使用强类型实体（而非BsonDocument），可以用类型安全的表达式方式设置别名，示例如下：

// 假设实体类为Product
var project = Builders<Product>.Projection
    .Expression(p => new { Name = p.NameField, p.Id });

这种方式能避免字符串拼写错误，更适合长期维护的项目。

内容的提问来源于stack exchange，提问作者Taimur Lak