本部分中的破坏性变更 (breaking change) 按引入它们的驱动程序版本进行分类。升级驱动程序版本时，请解决当前版本和升级版本之间的所有破坏性变更 (breaking change)。例如，如果您要将驱动程序从 v2.0 升级到 v2.20，请解决 v2.0 之后版本的所有破坏性变更 (breaking change)，包括 v2.20 下列出的任何更改。

版本 2.21.0破坏性变更

Atlas Search 构建器中 Render方法的函数签名已更改。以下代码片段显示了更改之前和更改之后的函数签名：

// Render function signature prior to v2.21.0
Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry);
// Render function signature in v2.21.0 and later
Render(SearchDefinitionRenderContext<TDocument> renderContext);

版本 2.19.0破坏性变更

ObjectSerializer 只允许对被视为安全的类型进行反序列化。如果没有另行指定，ObjectSerializer 将使用 ObjectSerializer.DefaultAllowedTypes 返回的类型。
要学习；了解有关 ObjectSerializer 的更多信息，请访问常见问题解答。有关 DefaultAllowedTypes 的更多信息，请访问API文档。

默认的 LinqProvider 已更改为 LINQ3。可以在 MongoClientSettings 中为 LINQ2 配置LinqProvider，如下面的代码示例所示：

var connectionString = "<connection string>";
var clientSettings = MongoClientSettings
   .FromConnectionString(connectionString);
clientSettings.LinqProvider = LinqProvider.V2;
var client = new MongoClient(clientSettings);

版本 2.14.0 破坏性变更 (breaking change)

此 MongoDB .NET/C# 驱动程序版本删除了对 .NET Framework v4.5.2 或更早版本的支持；支持的最低 .NET Framework 是 v4.7.2。
此版本的 MongoDB .NET/C# 驱动程序不支持 .NET 标准 v1.5；支持的最低 .NET 标准为 v2.0。

版本 2.13.0破坏性变更

删除了 slave0k 连接字符串选项；现在使用的是 readPreference 选项。

服务器版本兼容性更改

服务器版本兼容性更改是对 MongoDB .NET/C# 驱动程序的修改，不再支持一组 MongoDB 服务器版本。

该驱动程序在 MongoDB Server 版本的生命周期结束 (EOL) 后将停止支持。

要了解有关 MongoDB 对 EOL 产品的支持的更多信息，请参阅传统支持策略。

要详细学习；了解.NET/C#驱动程序版本和MongoDB Server版本之间的兼容性，请访问兼容性页面。

服务器版本8.1 支持变更

您无法使用 v2.14.1 或更早版本的 .NET/C# Driver 连接到运行 MongoDB Server v8.1 的部署。从MongoDB Server v8.1 开始，buildinfo 命令需要身份验证，从而导致与这些驱动程序版本不兼容。

版本 2.14 版本支持变更

v2.14 驱动程序不再支持 MongoDB Server v3.4 及更早版本。要使用 v2.14 及更高版本中的任何驱动程序，MongoDB Server 必须是 v3.6 或更高版本。

如要了解如何升级 MongoDB Server 部署，请参阅 MongoDB Server 手册中的发行说明。

后退

问题与帮助