.NET 7+ 中過時的 Windows Forms 功能

從 .NET 7 開始，某些 Windows Forms API 會標示為過時（否則會產生警告），其格式 WFDEVXXX 為 的自訂診斷識別碼。

如果您因為使用過時的 API 而遇到組建警告或錯誤，請遵循參考 一節中 所列診斷識別碼的特定指引。 對於過時的類型或成員，無法使用 標準診斷識別碼 （CS0618） 隱藏這些過時 的警告或錯誤;請改用自訂 WFDEVXXX 診斷識別碼值。 如需詳細資訊，請參閱隱藏警告。

參考

下表提供 .NET 7+ 中抹除和警告的索引 WFDEVXXX 。

診斷識別碼	警告或錯誤	描述
WFDEV001	警告	轉換至/從 IntPtr 是不安全的。 請改用 WParamInternal 、 LParamInternal 或 ResultInternal 。
WFDEV002	警告/錯誤	System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject 不再用來提供控制項的 DomainUpDown 無障礙支援。 請改用 AccessibleObject。
WFDEV003	警告	System.Windows.Forms.DomainUpDown.DomainItemAccessibleObject 不再用來為專案提供無障礙支援 DomainUpDown 。 請改用 AccessibleObject。

隱藏警告

建議您盡可能使用可用的因應措施。 不過，如果您無法變更程式碼，您可以透過 #pragma 指示詞或 <NoWarn> 專案設定來隱藏警告。 如果您必須使用過時的 API，而且 WFDEVXXX 診斷不會顯示為錯誤，您可以在程式碼或專案檔中隱藏警告。

若要隱藏程式碼中的警告：

// Disable the warning.
#pragma warning disable WFDEV001

// Code that uses obsolete API.
//...

// Re-enable the warning.
#pragma warning restore WFDEV001

若要隱藏專案檔中的警告：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
   <TargetFramework>net7.0</TargetFramework>
   <!-- NoWarn below suppresses WFDEV001 project-wide -->
   <NoWarn>$(NoWarn);WFDEV001</NoWarn>
   <!-- To suppress multiple warnings, you can use multiple NoWarn elements -->
   <NoWarn>$(NoWarn);WFDEV001</NoWarn>
   <NoWarn>$(NoWarn);WFDEV003</NoWarn>
   <!-- Alternatively, you can suppress multiple warnings by using a semicolon-delimited list -->
   <NoWarn>$(NoWarn);WFDEV001;WFDEV003</NoWarn>
  </PropertyGroup>
</Project>

注意

以這種方式隱藏警告只會停用您指定的抹去警告。 它不會停用任何其他警告，包括具有不同診斷識別碼的過時警告。

另請參閱

• .NET 5+ 中過時的 .NET 功能