.NET Framework 類別庫中的淘汰項目

  • 發行項

.NET Framework 會隨著時間而變更。 每個新版本都會加入一些提供新功能的新類型和類型成員。 現有的類型及其成員也會隨著時間改變。 例如，當某些型別所支援的技術由新技術取代時，這些型別的重要性會降低，而且某些方法會由在某方面更優異的新方法取代。

.NET Framework 和 Common Language Runtime 致力於支援回溯相容性 (讓使用某個 .NET Framework 版本所開發的應用程式能夠在下一個 .NET Framework 版本上執行)。 這點會讓您難以單純地移除類型或類型成員。 相反地，.NET Framework 會將某個類型或類型成員標記為「過時」或「已被取代」，表示不應該再使用該類型或類型成員。 藉由淘汰類型或成員，開發人員知道其會消失並有時間回應其移除。 不過，使用該型別或成員的現有程式碼仍然可繼續在新的 .NET 版本中執行。

注意

在 .NET (Core) 中，淘汰 API 不一定表示會移除 API。 如需詳細資訊，請參閱 .NET 中的 API 移除。

ObsoleteAttribute 屬性

.NET Framework 會使用 ObsoleteAttribute 屬性來標記某個型別或型別成員，表示該型別或型別成員已淘汰。 如果將這個屬性套用至某個型別或成員，就表示未來的某個版本將移除該型別或成員，但不會破壞使用該成員的已編譯程式碼。

除了表示某個類型或類型成員已過時之外，ObsoleteAttribute 也會定義編譯器如何處理包含該類型或成員的原始程式碼。 編譯器可能會編譯程式碼但發出警告訊息，也可能會將類型或成員的使用視為錯誤。 在第一種情況下，雖然程式碼可以成功編譯，但是警告訊息會指出類型或成員已過時。 在第二種情況下，編譯會失敗。

即使編譯產生錯誤而非警告訊息，ObsoleteAttribute 並不會影響執行階段行為。 也就是說，使用該類型或成員而且已成功編譯的應用程式一定會順利執行。 只有嘗試重新編譯使用該類型或成員之應用程式的作業會失敗。

如何處理已淘汰的類型和成員

當您升級和重新編譯現有的程式碼時，使用在應用程式中產生編譯器警告的過時類型或成員是可接受的作法。 不過，您應該檢閱編譯器警告訊息，以便判斷是否應該變更應用程式程式碼。 如果訊息沒有指向適當的替代方案，您就應該進行下列其中一項步驟：

  • 變更程式碼，不使用類型或成員 (如果可能的話)。

    -或-

  • 檢閱適用於這個技術領域的文件，以便判斷如何回應取代。

您可以選擇不要針對更新的 .NET Framework 版本重新編譯現有的程式碼， 而改為指定現有已編譯程式碼所執行的目標 .NET Framework 版本。 例如，假設您有一個名為 app1.exe 且已針對 .NET Framework 3.5 編譯的應用程式，但是您想要讓這個應用程式針對 .NET Framework 4.5 執行。 此時，您需要進行下列步驟：

  1. 建立主要可執行檔的組態檔，並將它命名為 appName.exe.config，其中 appName 是應用程式可執行檔的名稱。 對於範例中名為 app1.exe 的應用程式而言，您要建立名為 app1.exe.config 的組態檔。

  2. 將下列內容加入組態檔。

    <configuration>
   <startup>
      <supportedRuntime version="v4.0" />
   </startup>
</configuration>

若要以特定版本的 .NET Framework 為目標，請將下列其中一個字串值指派給 version 屬性：

.NET Framework 版本 version string
4.8 (包括 4.8.1) 4.0 版起
4.7 (包括 4.7.1 和 4.7.2) 4.0 版起
4.6 (包括 4.6.1 和 4.6.2) 4.0 版起
4.5 (包括 4.5.1 和 4.5.2) 4.0 版起
4 4.0 版起
3.5 v2.0.50727
2.0 v2.0.50727
1.1 v1.1.4322
1.0 v1.0.3705

Framework .NET 4.5 和更新版本已淘汰的 API

舊版已淘汰的 API

另請參閱