Thread.Abort メソッド

public:
 void Abort();

[System.Obsolete("Thread.Abort is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0006", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public void Abort ();

public void Abort ();

[<System.Obsolete("Thread.Abort is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0006", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
member this.Abort : unit -> unit

member this.Abort : unit -> unit

Public Sub Abort ()

属性

ObsoleteAttribute

例外

注釈

このメソッドは、互換性のために残されています。 .NET 5 以降のバージョンでは、このメソッドを呼び出してコンパイル時の警告が生成されます。 このメソッドは、実行時に .NET 5 以降および .NET Core で PlatformNotSupportedException をスローします。

このメソッドがスレッドで呼び出されると、システムはスレッド内の をスローして ThreadAbortException 中止します。 ThreadAbortException は、アプリケーション コードでキャッチできる特別な例外ですが、 が呼び出されていない限り、 ブロックの末尾 catch ResetAbort に再スローされます。 ResetAbort は中止する要求を取り消し、 が ThreadAbortException スレッドを終了するのを防ぐ。 実行されていないブロックは finally 、スレッドが中止される前に実行されます。

スレッドがすぐに中止される、または一切中止されない。 この状況は、中止プロシージャの一部として呼び出されるブロックでスレッドが無制限の量の計算を実行し、それによって中止を無期限に遅延する場合に発生する可能性 finally があります。 スレッドが中止されるまで待機するには、 メソッドを呼び出した後にスレッドで メソッドを呼び出しますが、待機が終了 Join Abort する保証はありません。

が開始されていないスレッドで が呼び出された場合、 が呼び出された場合、スレッド Abort Start は中止されます。 ブロックまたはスリープ状態のスレッドで が呼び出された場合、スレッドは中断され Abort 、中止されます。

中断されたスレッドで が呼び出された場合は、 を呼び出したスレッドで がスローされ、中止されるスレッドの プロパティ Abort ThreadStateException Abort AbortRequested ThreadState に追加されます。 が ThreadAbortException 呼び出されるまで、中断されたスレッドで Resume がスローされません。

アンマネージ コードの実行中にマネージド スレッドで が呼び出された場合、スレッドがマネージド コードに戻るまで、 は Abort ThreadAbortException スローされません。

2 つの呼び出しが同時に行う場合は、1 つの呼び出しで状態情報を設定し、もう 1 つの呼び出しで を実行 Abort することができます Abort 。 ただし、アプリケーションではこの状況を検出できません。

スレッド Abort で が呼び出されると、スレッドの状態に が含まれます AbortRequested 。 への正常な呼び出しの結果としてスレッドが終了すると、スレッドの状態 Abort が に変更されます Stopped 。 十分なアクセス許可を持つ場合、 のターゲットであるスレッドは、 メソッドを使用 Abort して中止を取り消 ResetAbort す可能性があります。 メソッドの呼び出しの例については ResetAbort 、 クラスを参照 ThreadAbortException してください。

こちらもご覧ください

• ThreadAbortException
• Aborted
• AbortRequested
• スレッドおよびスレッド処理
• スレッドの使用とスレッド処理
• スレッドの破棄

public:
 void Abort(System::Object ^ stateInfo);

[System.Obsolete("Thread.Abort is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0006", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public void Abort (object? stateInfo);

public void Abort (object stateInfo);

public void Abort (object? stateInfo);

[<System.Obsolete("Thread.Abort is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0006", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
member this.Abort : obj -> unit

member this.Abort : obj -> unit

Public Sub Abort (stateInfo As Object)

パラメーター

属性

ObsoleteAttribute

例外

例

次のコード例は、中断されているスレッドに情報を渡す方法を示しています。

using namespace System;
using namespace System::Threading;
ref class Test
{
private:
   Test(){}


public:
   static void TestMethod()
   {
      try
      {
         while ( true )
         {
            Console::WriteLine( "New thread running." );
            Thread::Sleep( 1000 );
         }
      }
      catch ( ThreadAbortException^ abortException ) 
      {
         Console::WriteLine( dynamic_cast<String^>(abortException->ExceptionState) );
      }

   }

};

int main()
{
   Thread^ newThread = gcnew Thread( gcnew ThreadStart( &Test::TestMethod ) );
   newThread->Start();
   Thread::Sleep( 1000 );
   
   // Abort newThread.
   Console::WriteLine( "Main aborting new thread." );
   newThread->Abort( "Information from main." );
   
   // Wait for the thread to terminate.
   newThread->Join();
   Console::WriteLine( "New thread terminated - main exiting." );
}

using System;
using System.Threading;

class Test
{
    public static void Main()
    {
        Thread newThread  = new Thread(new ThreadStart(TestMethod));
        newThread.Start();
        Thread.Sleep(1000);

        // Abort newThread.
        Console.WriteLine("Main aborting new thread.");
        newThread.Abort("Information from Main.");

        // Wait for the thread to terminate.
        newThread.Join();
        Console.WriteLine("New thread terminated - Main exiting.");
    }

    static void TestMethod()
    {
        try
        {
            while(true)
            {
                Console.WriteLine("New thread running.");
                Thread.Sleep(1000);
            }
        }
        catch(ThreadAbortException abortException)
        {
            Console.WriteLine((string)abortException.ExceptionState);
        }
    }
}

Imports System.Threading

Public Class Test

    <MTAThread> _
    Shared Sub Main()
        Dim newThread As New Thread(AddressOf TestMethod)
        newThread.Start()
        Thread.Sleep(1000)

        ' Abort newThread.
        Console.WriteLine("Main aborting new thread.")
        newThread.Abort("Information from Main.")

        ' Wait for the thread to terminate.
        newThread.Join()
        Console.WriteLine("New thread terminated - Main exiting.")
    End Sub

    Shared Sub TestMethod()
        Try
            While True
                Console.WriteLine("New thread running.")
                Thread.Sleep(1000)
            End While
        Catch abortException As ThreadAbortException
            Console.WriteLine( _
                CType(abortException.ExceptionState, String))
        End Try
    End Sub

End Class

注釈

このメソッドは、互換性のために残されています。 .NET 5 以降のバージョンでは、このメソッドを呼び出すと、コンパイル時の警告が生成されます。 このメソッドは、 PlatformNotSupportedException 実行時に .net 5 以降および .Net Core でをスローします。

このメソッドがスレッドで呼び出されると、システムはスレッドでをスローし ThreadAbortException て中止します。 ThreadAbortException は、アプリケーションコードでキャッチできる特殊な例外ですが、が呼び出されない限り、ブロックの末尾で再スローされ catch ResetAbort ます。 ResetAbort 中止要求をキャンセルし、がスレッドを終了できないようにし ThreadAbortException ます。 Unexecuted finally ブロックは、スレッドが中止される前に実行されます。

スレッドはすぐに中止されるとは限りません。 この状況は、スレッドが finally 中止プロシージャの一部として呼び出されたブロック内で無制限の計算を実行した場合に発生する可能性があります。これにより、中止が無期限に遅延されます。 スレッドが中止されるまで待機するには、メソッドを呼び出した後にスレッドでメソッドを呼び出すことができ Join Abort ますが、待機が終了する保証はありません。

が Abort 開始されていないスレッドでが呼び出された場合、スレッドはが呼び出されると中止され Start ます。 ブロックされている、またはスリープ状態の Abort スレッドでが呼び出された場合、スレッドは中断されてから中止されます。

Abort中断されたスレッドでが呼び出されると、が呼び出されたスレッドでがスローされ、 ThreadStateException Abort 中止されるスレッド AbortRequested のプロパティにが追加され ThreadState ます。 ThreadAbortExceptionが呼び出されるまで、中断されたスレッドではスローされません Resume 。

Abortアンマネージコードの実行中にマネージスレッドでが呼び出された場合、 ThreadAbortException スレッドがマネージコードに戻るまでは、がスローされません。

2つの呼び出しが同時に行わ Abort れる場合は、1回の呼び出しで状態情報を設定し、もう一方の呼び出しでを実行することができ Abort ます。 ただし、アプリケーションでこの状況を検出することはできません。

Abortスレッドでが呼び出された後、スレッドの状態にはが含まれ AbortRequested ます。 の呼び出しが成功した結果としてスレッドが終了すると Abort 、スレッドの状態がに変更され Stopped ます。 十分なアクセス許可がある場合、のターゲットであるスレッドは、 Abort メソッドを使用して中止を取り消すことができ ResetAbort ます。 メソッドの呼び出しを示す例につい ResetAbort ては、クラスを参照してください ThreadAbortException 。

こちらもご覧ください

• ThreadAbortException
• Aborted
• AbortRequested
• スレッドおよびスレッド処理
• スレッドの使用とスレッド処理
• スレッドの破棄