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

Примеры

В следующем примере показано прерывание потока. Поток, который получает ThreadAbortExceptionResetAbort метод для отмены запроса прерывания и продолжения выполнения.

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 метода для уничтожения потока среда CLR создает ThreadAbortException вызов в .NET Framework. ThreadAbortException — это специальное исключение, которое может быть поймано, но оно автоматически будет поднято снова в конце catch блока. При возникновении этого исключения среда выполнения выполняет все finally блоки перед завершением потока. Так как поток может выполнять несвязанные вычисления в finally блоках или вызывать Thread.ResetAbort отмену прерывания, нет никакой гарантии, что поток когда-либо закончится. Если вы хотите дождаться завершения прерванного потока, можно вызвать Thread.Join метод. Join — это блокирующий вызов, который не возвращается, пока поток фактически не перестанет выполняться.

Замечание

Только .NET Core и .NET 5+ Несмотря на то, что этот тип существует в .NET Core и .NET 5+, так как Abort не поддерживается, среда CLR никогда не будет вызываться ThreadAbortException.

Замечание

Когда среда CLR останавливает фоновые потоки после завершения всех потоков переднего плана в управляемом исполняемом файле, он не используется Thread.Abort. Поэтому не удается ThreadAbortException определить, когда фоновые потоки завершаются средой CLR.

ThreadAbortException использует HRESULT COR_E_THREADABORTED, который имеет значение 0x80131530.

Замечание

Значение унаследованного 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()	При переопределении в производном классе возвращает Exception первопричину одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Устаревшие.. При переопределении в производном классе задает SerializationInfo сведения об исключении. (Унаследовано от Exception)
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

Имя	Описание
SerializeObjectState	Устаревшие.. Происходит при сериализации исключения для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception)

См. также раздел

• Thread
• Abort(Object)
• Уничтожение потоков