移植代码时可能会发生重大更改

影响兼容性的更改(也称为重大改变)将在不同版本的 .NET 中出现。 由于某些技术不可用,从 .NET Framework 移植到 .NET 时,更改会受到影响。 此外,由于 .NET 是一种跨平台技术,而 .NET Framework 不是,所以您可能会遇到重大变更。

Microsoft 努力保持 .NET 版本之间的高兼容性,因此,尽管会出现重大变更,但它们会经过仔细考虑。

在升级主要版本之前,请查看重大更改文档,了解可能影响你的更改。

影响兼容性的更改

库作者可以进行多种类型的更改,这些更改会影响兼容性,包括:

  • 对公共协定的修改
  • 行为变更
  • 平台支持
  • 内部实现更改
  • 代码更改

有关允许或禁止的更改类型的详细信息,请参阅 “更改规则”以实现兼容性

兼容性类型

兼容性是指能够在最初开发代码时使用的 .NET 实现之外的其他 .NET 实现上编译或运行代码的能力。

有六种不同的更改方式会影响兼容性:

  • 行为变更
  • 二进制兼容性
  • 源兼容性
  • 设计阶段兼容性
  • 向后兼容性
  • 向前兼容性

有关详细信息,请参阅 代码更改如何影响兼容性

查找中断性变更

我们记录了影响兼容性的更改。 在将代码从 .NET Framework 移植到 .NET 或将其升级到较新版本的 .NET 之前,请查看这些更改。 有关这些中断性变更的列表,请参阅 从 .NET Framework 迁移到 .NET Core 的中断性变更