新增功能

在此页面上

即将发生的破坏性变更 (breaking change)

3.3 中的新功能
3.2 中的新功能
3.1 中的新功能
3.0 中的新功能
2.30 中的新功能
2.29 中的新功能
2.28 中的新功能
2.27 中的新功能
2.26 中的新功能
2.25 中的新功能

了解以下版本中的新功能：

版本 3.3
版本 3.2
版本 3.1
版本 3.0
版本 2.30
版本 2.29
版本 2.28
版本 2.27
版本 2.26
版本 2.25

即将发生的破坏性变更 (breaking change)

根据MongoDB软件生命周期时间表，即将发布的.NET/ C#驱动程序的次要版本会将MongoDB Server 的最低版本从 4.0 提高到 4.2。 .NET/ C#驱动程序将不再支持MongoDB Server 4.0。

3.3 中的新功能

3.3驱动程序版本包括以下新功能：

添加新的 NamespaceType 字段，指示为 ChangeStreamDocument 类中的 create 事件创建的对象的类型。要学习；了解有关变更流的更多信息，请参阅监控数据变更指南。
添加以下“正在使用的加密”功能：
- 支持 $lookup聚合阶段
- 用于配置数据加密密钥缓存生命周期的 ClientEncryptionOptions属性
要学习；了解有关“正在使用的加密”的更多信息，请参阅“正在使用的加密”指南。
添加以下 LINQ 功能：
- 支持SkipWhile() 和TakeWhile() LINQ聚合方法。要学习；了解更多信息，请参阅 LINQ指南的“跳过条件”和“限制条件”部分。
- 支持 LINQ 查询中的 $sigmoid表达式。
- 支持使用 LINQ 语法访问权限任何序列化为字符串的字典键，无论其根本的数据类型如何。
新增对 $rankFusion聚合阶段的支持，该阶段可对多个管道的合并结果进行基于排名的结果评分。
通过提供仅采用过滤参数的 ElemMatch() 方法的重载，添加对直接针对值的 $elemMatch 查询的支持。要学习；了解更多信息，请参阅构建器指南的数组操作符部分。
新增对使用 OfType<T>() 方法和 is操作符检查标量鉴别器类型的支持。

3.2 中的新功能

3.2驱动程序版本包括以下新功能：

添加了新的 ObjectSerializerAllowedTypesConvention 约定，允许指定对象序列化器可以对哪些类型进行序列化和反序列化。要学习；了解有关约定的更多信息，请参阅约定指南。
为 EnumRepresentationConvention 类添加一个新的构造函数，该构造函数允许您使用 topLevelOnly 参数来指定该约定是仅适用于枚举属性还是适用于包含枚举集合的所有属性。
您可以使用 new 构造函数实例化 EnumRepresentationConvention 类，如以下示例所示：
```
EnumRepresentationConvention(BsonType representation, bool topLevelOnly);
```
优化客户端投影，仅从服务器检索必填字段，而不是检索所有字段然后进行过滤。
添加以下类以支持Atlas Vector Search中的二进制向量表示：
- BinaryVectorFloat32
- BinaryVectorInt8
- BinaryVectorPackedBit
要学习；了解有关使用.NET/ C#驱动程序的Atlas Vector Search 的更多信息，请参阅Atlas Vector Search指南。
将DocumentFormat 属性添加到DateOnlySerializer 。此属性允许您自定义驾驶员序列化DateOnly 值的方式。此发布还添加了属性，以便在属性级别自定义[BsonDateOnlyOptions()] DateOnly值的序列化行为。要学习；了解更多信息，请参阅 POCO指南的自定义仅日期序列化部分。

3.1 中的新功能

3.1驱动程序版本包括以下新功能：

为System.Collections.Immutable命名空间中的不可变集合添加新的默认序列化器。驾驶员现在可以序列化 ImmutableArray 对象，并且其他不可变集合的序列化内存效率更高。
添加 SearchIndexType 类型以支持以编程方式创建Atlas Vector Search索引。要学习；了解更多信息，请参阅Atlas Search和 Vector Search 索引指南。
使用 equals操作符符的Atlas Search构建者添加对令牌字段类型和大量字段表达式的支持。要学习；了解有关将Atlas Search与.NET/ C#驱动程序结合使用的更多信息，请参阅Atlas Search。
新增对以下Atlas Search查询的支持：
- 对 null 和 Guid 值使用 Equals()操作符方法
- 对 Guid 值使用 In()操作符方法
要学习；了解有关这些方法的更多信息，请参阅Atlas Search Search指南的Atlas Search Search 操作符和收集器部分。
在Atlas Search中添加对顺序分页的支持。
新增对少于 3 部分的有效 SRV 主机名的支持。
在MongoDB查询API筛选器中添加对 Exists、IsMissing 和 IsNullOrMissing 方法的支持。
添加对精确最近邻 (ENN)向量搜索的支持。要学习；了解有关新奥向量搜索的更多信息，请参阅Atlas Search文档中的运行向量搜索查询。
为更新和替换操作添加排序选项。此更改允许您在尝试更新或替换单个文档时，如果有多个文档与过滤匹配，则可以设立排序顺序。要学习；了解更多信息，请参阅更新文档和替换文档指南。

有关此发布的更多信息，请参阅 v3.1 发布说明。

3.0 中的新功能

警告

v 3.0 中的重大更改

v 3.0驾驶员包含重大更改。有关更多信息，请参阅版本3.0 重大更改。

3.0驱动程序版本包括以下新功能：

添加 MongoClientSettings.TranslationOptions 连接选项，该选项指定用于将 LINQ 查询转换为 Query API的选项。有关详细信息，请参阅连接选项。
添加对 Half 类型的支持，该类型表示半精度浮点数。此类型在.NET 5 及更高版本中可用。要学习；了解有关Half 类型的更多信息，请参阅 MSDN 上的“半结构体API ”参考页面。
IMongoClient 接口继承 IDisposable 接口。因此，实现IMongoClient 接口的 MongoClient 类和其他类都包含 Dispose() 方法，该方法可对客户端进行处置。此方法不会释放根本的集群以及与MongoDB 服务器的连接。要销毁集群和连接，请调用 ClusterRegistry.UnregisterAndDisposeCluster() 方法。IDisposable 接口的实施是实验性的。
要学习；了解有关IDisposable 接口和使用Dispose() 方法的详情，请参阅 MSDN 上的“处置模式”。
新增对 DateOnly 类型的支持，该类型表示不带时间组件的日期值。此类型在.NET 6 及更高版本中可用。要学习；了解有关DateOnly 类型的更多信息，请参阅 DateOnly 结构体。MSDN 上的API参考页面。
新增对 TimeOnly 类型的支持，该类型表示不带日期组件的时间值。此类型在.NET 6 及更高版本中可用。要学习；了解有关TimeOnly 类型的更多信息，请参阅 TimeOnly 结构体。MSDN 上的API参考页面。

添加在将 Find() 方法、Select() 方法或 Project()聚合阶段与 LINQ 3提供商一起使用时对隐式客户端投影的支持。在以前版本的驾驶员中，只有在调用 ToEnumerable() 或 AsEnumerable() 方法后，才能使用 LINQ 3提供商执行客户端投影。

要学习；了解如何为驾驶员方法启用和使用客户端投影，请选择相应的标签页：

// Enable client-side projection
var findOptions = new FindOptions();
findOptions.TranslationOptions = new ExpressionTranslationOptions
{
    EnableClientSideProjections = true
};
var find = collection
    .Find(doc => doc.Id == 1, findOptions);
    .Project(doc => new { R = MyFunction(doc.Name) });

// Enable client-side projection
var aggregateOptions = new AggregateOptions();
aggregateOptions.TranslationOptions = new ExpressionTranslationOptions
{
    EnableClientSideProjections = true
};
var queryable = collection
    .AsQueryable(aggregateOptions)
    .Where(doc => doc.Id == 1)
    .Select(doc => new { R = MyFunction(doc.Name) });

// Enable client-side projection
var aggregateOptions = new AggregateOptions();
aggregateOptions.TranslationOptions = new ExpressionTranslationOptions
{
    EnableClientSideProjections = true
};
var aggregate = collection
    .Aggregate(aggregateOptions)
    .Project(doc => new { R = MyFunction(doc.Name) });

提示

MongoClientSettings

要为客户端上的所有查询启用客户端客户端投影，请设立MongoClientSettings对象的 TranslationOptions属性，如以下示例所示：

clientSettings.TranslationOptions = new ExpressionTranslationOptions
{
    EnableClientSideProjections = true
};

要学习；了解有关将聚合管道与.NET/ C#驱动程序结合使用的更多信息，请参阅聚合。

为批量写入操作添加 MongoClient API 。要学习；了解有关批量写入操作的更多信息，请参阅批量写入操作。

有关此发布的更多信息，请参阅 v3.0 发布说明。

2.30 中的新功能

2.30驾驶员不会引入新功能或错误修复。其目的是通过将 v 3.0 中删除的公共 API 标记为已过时，以便轻松迁移到.NET/ C#驱动程序v 3 .x。

2.29 中的新功能

2.29驾驶员发布增加了对MongoDB Server 8.0版本的支持，并包含以下新功能：

新增支持v 2的Queryable Encryption范围协议的支持。
添加对Queryable Encryption范围索引的支持。有关Queryable Encryption的更多信息，请参阅MongoDB Server手册中的Queryable Encryption 。

有关此发布的更多信息，请参阅 v2.29 发布说明。

2.28 中的新功能

警告

v 2.28中潜在的重大更改

所有.NET/ C#驱动程序组件都有强命名。如果应用程序具有引用多个.NET/ C#驱动程序版本的依赖项，则必须创建绑定重定向来管理这些依赖项。有关更多信息，请参阅版本 2.28.0重大更改。

2.28驱动程序版本包括以下新功能：

添加了对涉及Nullable<T>的其他数字转换的支持。
添加了在使用 KMIP 进行CSFLE 或Queryable Encryption时对delegated选项的支持。

有关此发布的更多信息，请参阅 v2.28 发布说明。

2.27 中的新功能

2.27驱动程序版本包括以下新功能：

新增支持$sample聚合操作符的支持。
为 LINQ 3中的序列化器实现Equals()方法。
确保读关注和写入关注不会应用于Atlas Search索引助手命令，以避免错误。
使用 MONGODB-OIDC身份验证机制时，禁止在 authMechanismProperties 连接string值中使用逗号字符。
修复了一个转换错误，该错误在涉及不同大小的数字的序列化过程中导致错误。
新增对使用libdl.so.2库的Linux发行版的支持。

有关此发布的更多信息，请参阅 v2.27 发布说明。

2.26 中的新功能

2.26驱动程序版本包括以下新功能：

添加了对在Select()和Project()聚合阶段使用SelectMany()聚合方法的支持。
在 LINQ 查询中添加了对Dictionary.ContainsValue()调用的支持。
添加了对混合类型string连接的支持。
支持在libmongocrypt绑定中使用原生crypto 。
添加了对 Memory 和 ReadOnlyMemory 结构序列化的支持。要学习；了解有关实现这些类型的更多信息，请参阅序列化指南的“提高数组序列化性能”部分。
添加了使用MONGODB-OIDC身份验证机制时对GCP身份提供商的支持。要学习；了解更多信息，请参阅企业身份验证机制指南中的GCP IMDS 。
实现了 NuGet 包的签名。
尽可能对其他mongos实例实施读取和写入重试。

2.25 中的新功能

2.25驱动程序版本包括以下新功能：

添加了对MONGODB-OIDC身份验证机制和 Azure 身份提供者自动获取令牌的支持。
在BsonClassMapSerializer找不到匹配的创建者时报告的错误消息中添加了类名称。
添加了LoggedStages字段以显示执行 LINQ查询后执行的MQL 。
添加了对通过使用 srvServiceName 连接选项以自定义服务名称覆盖 "mongodb" 服务名称的支持。要学习；了解更多信息，请参阅连接选项指南。
改进批量写入操作的行为，以防止多次枚举请求参数。

后退

快速参考

来年

使用示例