Thread.Abort 已過時

Thread.AbortAPI 已過時。 如果呼叫這些方法,以 .NET 5 或更新版本為目標的專案將會遇到編譯時間警告 SYSLIB0006

變更描述

先前,對 的呼叫 Thread.Abort 不會產生編譯時期警告,不過,方法在執行時間擲回 PlatformNotSupportedException

從 .NET 5 開始, Thread.Abort 標示為已過時的警告。 呼叫這個方法會產生編譯器警告 SYSLIB0006 。 方法的實作不會變更,而且會繼續擲回 PlatformNotSupportedException

變更的原因

Thread.Abort假設一律在所有 .NET 實作上擲回 PlatformNotSupportedException ,但.NET Framework除外, ObsoleteAttribute 已新增至 方法,以注意呼叫的位置。

當您呼叫 Thread.Abort 中止目前線程以外的執行緒時,您不知道擲回 時 ThreadAbortException ,哪些程式碼已執行或無法執行。 您也無法確定應用程式的狀態或任何應用程式及其負責保留的使用者狀態。 例如,呼叫 Thread.Abort 可能會防止執行靜態建構函式,或釋放 Managed 或 Unmanaged 資源。 基於這個理由, Thread.Abort 一律會在 .NET Core 和 .NET 5+ 上擲回 PlatformNotSupportedException

導入的版本

5.0

  • CancellationToken使用 中止處理工作單位,而不是呼叫 Thread.Abort 。 下列範例說明 如何使用 CancellationToken

    void ProcessPendingWorkItemsNew(CancellationToken cancellationToken)
    {
        if (QueryIsMoreWorkPending())
        {
            // If the CancellationToken is marked as "needs to cancel",
            // this will throw the appropriate exception.
            cancellationToken.ThrowIfCancellationRequested();
    
            WorkItem work = DequeueWorkItem();
            ProcessWorkItem(work);
        }
    }
    

    如需詳細資訊,請參閱 Managed 執行緒中的取消

  • 若要隱藏編譯時期警告,請隱藏警告碼 SYSLIB0006 。 警告程式碼是專屬 Thread.Abort 的,並隱藏它不會隱藏程式碼中的其他隱藏警告。 不過,我們建議您移除 的 Thread.Abort 呼叫,而不是隱藏警告。

    void MyMethod()
    {
    #pragma warning disable SYSLIB0006
        Thread.CurrentThread.Abort();
    #pragma warning restore SYSLIB0006
    }
    

    您也可以隱藏專案檔中的警告。

    <PropertyGroup>
      <OutputType>Exe</OutputType>
      <TargetFramework>net5.0</TargetFramework>
      <!-- Disable "Thread.Abort is obsolete" warnings for entire project. -->
      <NoWarn>$(NoWarn);SYSLIB0006</NoWarn>
    </PropertyGroup>
    

受影響的 API