ThreadAbortException Třída

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.Thread.dll

Zdroj:

ThreadAbortException.cs

Výjimka, která je vyvolán při volání metody Abort(Object) . Tuto třídu nelze zdědit.

public ref class ThreadAbortException sealed : SystemException

public sealed class ThreadAbortException : SystemException

type ThreadAbortException = class
    inherit SystemException

Public NotInheritable Class ThreadAbortException
Inherits SystemException

Dědičnost

Object

Exception

SystemException

ThreadAbortException

Příklady

Následující příklad ukazuje přerušení vlákna. Vlákno, které obdrží ThreadAbortException pomocí ResetAbort metody zrušit požadavek a přerušit a pokračovat v provádění.

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

Tento kód vytvoří následující výstup:

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.

Poznámky

Při volání Abort metody zničit vlákno, common language runtime vyvolá v ThreadAbortException rozhraní .NET Framework. ThreadAbortException je zvláštní výjimka, kterou lze zachytit, ale automaticky se znovu vyvolá na konci catch bloku. Při vyvolání této výjimky spustí modul runtime všechny finally bloky před ukončením vlákna. Protože vlákno může provádět nevázané výpočty v finally blocích nebo volání Thread.ResetAbort zrušit přerušení, neexistuje žádná záruka, že vlákno bude ukončeno. Pokud chcete počkat na ukončení přerušeného vlákna, můžete metodu Thread.Join volat. Join je blokující volání, které se nevrátí, dokud vlákno ve skutečnosti zastaví provádění.

Poznámka:

Pouze .NET Core a .NET 5 nebo novější: I když tento typ existuje v .NET Core a .NET 5+, protože Abort se nepodporuje, modul CLR (Common Language Runtime) nikdy nevyvolá chybu ThreadAbortException.

Poznámka:

Když clr (Common Language Runtime) zastaví vlákna na pozadí po ukončení všech vláken popředí ve spravovaném spustitelném souboru, nepoužívá Thread.Abort. Proto nelze použít ThreadAbortException ke zjištění, kdy jsou vlákna na pozadí ukončena clR.

ThreadAbortException používá HRESULT COR_E_THREADABORTED, který má hodnotu 0x80131530.

Poznámka:

Hodnota zděděné Data vlastnosti je vždy null.

Vlastnosti

Name	Description
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
ExceptionState	Získá objekt, který obsahuje informace specifické pro aplikaci související s vláknem přerušení.
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Při přepsání v odvozené třídě nastaví SerializationInfo s informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• Thread
• Abort(Object)
• Zničení vláken