Docs 菜单
Docs 主页
/
语言
/
C#/.NET
/
C#/.NET

升级驱动程序版本

在此页面上

  • Overview
  • 重大更改
  • 服务器版本兼容性更改

Overview

在此部分中，您可以确定必须对应用程序进行哪些重要更改，才能将驱动程序升级到新版本。

升级前，请执行以下操作：

  • 确保新版本与应用程序连接到的MongoDB Server版本以及应用程序运行所在的.NET框架版本兼容。 有关此信息，请参阅 .NET/ C#驱动程序兼容性页面。

  • 在破坏性变更 (breaking change) 部分解决应用程序使用的驱动程序的当前版本与计划升级版本之间发生的任何破坏性变更 (breaking change)。要了解有关 MongoDB 服务器版本兼容性变更的更多信息，请参阅服务器版本兼容性变更部分。

提示

为了最大限度地减少将来升级驱动程序版本时应用程序可能需要的更改次数，请使用 Stable API。

重大更改

破坏性变更 (breaking change) 是对从特定版本的驱动程序开始的约定或行为的修改。如果在升级驱动程序之前未解决，此类更改可能会导致应用程序无法正常工作。

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

版本 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 版本之间的兼容性，请访问兼容性页面。

版本 2.14 版本支持变更

后退

兼容性