ThreadAbortException クラス

定義

名前空間:

System.Threading

アセンブリ:

netstandard.dll, System.Threading.Thread.dll

ソース:

ThreadAbortException.cs

Abort(Object) メソッドへの呼び出しが行われたときにスローされる例外。 このクラスは継承できません。

public ref class ThreadAbortException sealed : SystemException

public sealed class ThreadAbortException : SystemException

type ThreadAbortException = class
    inherit SystemException

Public NotInheritable Class ThreadAbortException
Inherits SystemException

継承

Object

Exception

SystemException

ThreadAbortException

例

次の例では、スレッドの中止を示します。 ThreadAbortExceptionを受け取るスレッドは、ResetAbort メソッドを使用して中止要求を取り消し、実行を続行します。

using System;
using System.Threading;
using System.Security.Permissions;

public class ThreadWork {
    public static void DoWork() {
        try {
            for(int i=0; i<100; i++) {
                Console.WriteLine("Thread - working.");
                Thread.Sleep(100);
            }
        }
        catch(ThreadAbortException e) {
            Console.WriteLine("Thread - caught ThreadAbortException - resetting.");
            Console.WriteLine("Exception message: {0}", e.Message);
            Thread.ResetAbort();
        }
        Console.WriteLine("Thread - still alive and working.");
        Thread.Sleep(1000);
        Console.WriteLine("Thread - finished working.");
    }
}

class ThreadAbortTest {
    public static void Main() {
        ThreadStart myThreadDelegate = new ThreadStart(ThreadWork.DoWork);
        Thread myThread = new Thread(myThreadDelegate);
        myThread.Start();
        Thread.Sleep(100);
        Console.WriteLine("Main - aborting my thread.");
        myThread.Abort();
        myThread.Join();
        Console.WriteLine("Main ending.");
    }
}

Imports System.Threading
Imports System.Security.Permissions


Public Class ThreadWork
   Public Shared Sub DoWork()
      Try
         Dim i As Integer
         For i = 0 To 99
            Console.WriteLine("Thread - working.")
            Thread.Sleep(100)
         Next i
      Catch e As ThreadAbortException
         Console.WriteLine("Thread - caught ThreadAbortException - resetting.")
         Console.WriteLine("Exception message: {0}", e.Message)
         Thread.ResetAbort()
      End Try
      Console.WriteLine("Thread - still alive and working.")
      Thread.Sleep(1000)
      Console.WriteLine("Thread - finished working.")
   End Sub
End Class


Class ThreadAbortTest
   Public Shared Sub Main()
      Dim myThreadDelegate As New ThreadStart(AddressOf ThreadWork.DoWork)
      Dim myThread As New Thread(myThreadDelegate)
      myThread.Start()
      Thread.Sleep(100)
      Console.WriteLine("Main - aborting my thread.")
      myThread.Abort()
      myThread.Join()
      Console.WriteLine("Main ending.")
   End Sub
End Class

このコードでは、次の出力が生成されます。

Thread - working.
Main - aborting my thread.
Thread - caught ThreadAbortException - resetting.
Exception message: Thread was being aborted.
Thread - still alive and working.
Thread - finished working.
Main ending.

注釈

スレッドを破棄するために Abort メソッドを呼び出すと、共通言語ランタイムは .NET Framework で ThreadAbortException をスローします。 ThreadAbortException は、キャッチできる特別な例外ですが、 catch ブロックの最後に自動的に再び発生します。 この例外が発生すると、ランタイムはスレッドを終了する前にすべての finally ブロックを実行します。 スレッドは、 finally ブロックで無制限の計算を実行したり、 Thread.ResetAbort を呼び出して中止を取り消したりできるため、スレッドが終了する保証はありません。 中止されたスレッドが終了するまで待機する場合は、 Thread.Join メソッドを呼び出すことができます。 Join は、スレッドが実際に実行を停止するまで戻らないブロッキング呼び出しです。

注

.NET Core と .NET 5 以降のみ: この型は .NET Core と .NET 5 以降に存在しますが、 Abort はサポートされていないため、共通言語ランタイムは ThreadAbortExceptionをスローすることはありません。

注

マネージド実行可能ファイル内のすべてのフォアグラウンド スレッドが終了した後、共通言語ランタイム (CLR) によってバックグラウンド スレッドが停止された場合、 Thread.Abortは使用されません。 そのため、 ThreadAbortException を使用して、CLR によってバックグラウンド スレッドが終了するタイミングを検出することはできません。

ThreadAbortExceptionでは、0x80131530値を持つHRESULT COR_E_THREADABORTEDが使用されます。

注

継承された Data プロパティの値は常に null。

プロパティ

名前	説明
Data	例外に関する追加のユーザー定義情報を提供するキーと値のペアのコレクションを取得します。 (継承元 Exception)
ExceptionState	スレッドの中止に関連するアプリケーション固有の情報を含むオブジェクトを取得します。
HelpLink	この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 (継承元 Exception)
HResult	特定の例外に割り当てられるコード化された数値である HRESULT を取得または設定します。 (継承元 Exception)
InnerException	現在の例外の原因となった Exception インスタンスを取得します。 (継承元 Exception)
Message	現在の例外を説明するメッセージを取得します。 (継承元 Exception)
Source	エラーの原因となるアプリケーションまたはオブジェクトの名前を取得または設定します。 (継承元 Exception)
StackTrace	呼び出し履歴のイミディエイト フレームの文字列表現を取得します。 (継承元 Exception)
TargetSite	現在の例外をスローするメソッドを取得します。 (継承元 Exception)

メソッド

名前	説明
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBaseException()	派生クラスでオーバーライドされた場合、1 つ以上の後続の例外の根本原因である Exception を返します。 (継承元 Exception)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	古い. 派生クラスでオーバーライドされた場合は、例外に関する情報を使用して SerializationInfo を設定します。 (継承元 Exception)
GetType()	現在のインスタンスのランタイム型を取得します。 (継承元 Exception)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ToString()	現在の例外の文字列形式を作成して返します。 (継承元 Exception)

イベント

名前	説明
SerializeObjectState	古い. 例外に関するシリアル化されたデータを含む例外状態オブジェクトを作成するために例外がシリアル化されるときに発生します。 (継承元 Exception)

こちらもご覧ください

• Thread
• Abort(Object)
• スレッドの破棄