閱讀英文

共用方式為


移植程式碼時可能會發生中斷性變更

影響相容性的變更 (也稱為中斷性變更) 將發生於 .NET 版本之間。 從 .NET Framework 移植到 .NET 時,變更會因為某些技術無法使用而受到影響。 此外,由於 .NET 是一個跨平台技術,但 .NET Framework 不是,因此,您可能會遇到中斷性變更。

Microsoft 致力於維護 .NET 版本之間的高階相容性,因此,在確實發生中斷性變更時,要仔細考慮它們。

升級主要版本之前,請檢查中斷性變更文件,以了解可能會對您產生影響的變更。

影響相容性的變更

有數種類型的變更是程式庫作者可進行來影響相容性的變更,包括:

  • 公用合約的修改
  • 行為變更
  • 平台支援
  • 內部實作的變更
  • 程式碼變更

如需允許或不允許何種變更的詳細資訊,請參閱變更相容性規則 (部分機器翻譯)。

相容性類型

相容性是指在 .NET 實作上編譯或執行程式碼的能力,而該實作與原先開發程式碼時所使用的實作不同。

變更可能會影響相容性的方式有六種:

  • 行為變更
  • 二進位相容性
  • 來源相容性
  • 設計階段相容性
  • 回溯相容性
  • 往後相容性

如需詳細資訊,請參閱程式碼變更如何影響相容性 (部分機器翻譯)。

尋找中斷性變更

記錄會影響相容性的變更。 檢閱這些變更,然後再將程式碼從 .NET Framework 移植到 .NET,或將其升級至較新版的 .NET。 如需這些中斷性變更的清單,請參閱從 .NET Framework 移轉至 .NET Core 的中斷性變更