ThreadAbortException クラス

定義

名前空間:

System.Threading

アセンブリ:

System.Threading.Thread.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

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

public ref class ThreadAbortException sealed : SystemException

public sealed class ThreadAbortException : SystemException

[System.Serializable]
public sealed class ThreadAbortException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ThreadAbortException : SystemException

type ThreadAbortException = class
    inherit SystemException

[<System.Serializable>]
type ThreadAbortException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ThreadAbortException = class
    inherit SystemException

Public NotInheritable Class ThreadAbortException
Inherits SystemException

継承

Object

Exception

SystemException

ThreadAbortException

属性

SerializableAttribute ComVisibleAttribute

例

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

using namespace System;
using namespace System::Threading;
using namespace System::Security::Permissions;
ref 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." );
   }

};

int main()
{
   ThreadStart^ myThreadDelegate = gcnew ThreadStart( ThreadWork::DoWork );
   Thread^ myThread = gcnew Thread( myThreadDelegate );
   myThread->Start();
   Thread::Sleep( 100 );
   Console::WriteLine( "Main - aborting my thread." );
   myThread->Abort();
   myThread->Join();
   Console::WriteLine( "Main ending." );
}

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 は、スレッドが実際に実行を停止するまで戻らないブロック呼び出しです。

Note

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

Note

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

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

Note

継承された 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)
• スレッドの破棄