ThreadAbortException Osztály

Definíció

Névtér:

System.Threading

Szerelvények:

netstandard.dll, System.Threading.Thread.dll

Forrás:

ThreadAbortException.cs

A metódus hívásakor Abort(Object) megjelenő kivétel. Ez az osztály nem örökölhető.

public ref class ThreadAbortException sealed : SystemException

public sealed class ThreadAbortException : SystemException

type ThreadAbortException = class
    inherit SystemException

Public NotInheritable Class ThreadAbortException
Inherits SystemException

Öröklődés

Object

Exception

SystemException

ThreadAbortException

Példák

Az alábbi példa egy szál megszakítását mutatja be. A folyamatot fogadó ThreadAbortException szál a ResetAbort megszakítási kérelem megszakítására és a végrehajtás folytatására használja a metódust.

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

Ez a kód a következő kimenetet állítja elő:

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.

Megjegyzések

Amikor a Abort metódusra irányuló hívással elpusztít egy szálat, a közös nyelvi futtatókörnyezet ThreadAbortException dob .NET-keretrendszerre. ThreadAbortException ez egy különleges kivétel, amely fogott, de automatikusan emeli újra a blokk végén catch . A kivétel felmerülésekor a futtatókörnyezet végrehajtja az összes blokkot a finally szál befejezése előtt. Mivel a szál kötetlen számítást végezhet a finally blokkokban, vagy meghívhatja Thread.ResetAbort a megszakítás megszakítását, nincs garancia arra, hogy a szál valaha is véget ér. Ha meg szeretné várni, amíg a megszakított szál véget nem ér, meghívhatja a metódust Thread.Join . Join egy blokkoló hívás, amely addig nem tér vissza, amíg a szál ténylegesen le nem állítja a végrehajtást.

Note

.NET Core és .NET 5+ csak: Annak ellenére, hogy ez a típus .NET Core és .NET 5+, mivel Abort nem támogatott, a közös nyelvi futtatókörnyezet soha nem dobja ThreadAbortException.

Note

Ha a közös nyelvi futtatókörnyezet (CLR) leállítja a háttérszálakat, miután egy felügyelt végrehajtható fájl összes előtérszála véget ért, akkor nem használja Thread.Abort. Ezért nem ThreadAbortException tudja észlelni, hogy a CLR mikor szakítja meg a háttérszálakat.

ThreadAbortException használja HRESULT COR_E_THREADABORTED, amelynek értéke 0x80131530.

Note

Az örökölt Data tulajdonság értéke mindig null.

Tulajdonságok

Name	Description
Data	Lekéri a kulcs-/érték párok gyűjteményét, amelyek további, felhasználó által definiált információkat biztosítanak a kivételről. (Öröklődés forrása Exception)
ExceptionState	Lekéri a szál megszakításával kapcsolatos alkalmazásspecifikus információkat tartalmazó objektumot.
HelpLink	Lekéri vagy beállítja a kivételhez társított súgófájlra mutató hivatkozást. (Öröklődés forrása Exception)
HResult	Lekéri vagy beállítja a HRESULT-ot, egy kódolt numerikus értéket, amely egy adott kivételhez van hozzárendelve. (Öröklődés forrása Exception)
InnerException	Lekéri az Exception aktuális kivételt okozó példányt. (Öröklődés forrása Exception)
Message	Az aktuális kivételt leíró üzenet jelenik meg. (Öröklődés forrása Exception)
Source	Lekéri vagy beállítja az alkalmazás vagy a hibát okozó objektum nevét. (Öröklődés forrása Exception)
StackTrace	Lekéri a hívásverem közvetlen kereteinek sztringképét. (Öröklődés forrása Exception)
TargetSite	Lekéri az aktuális kivételt okozó metódust. (Öröklődés forrása Exception)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBaseException()	Ha egy származtatott osztály felül van bírálva, egy Exception vagy több későbbi kivétel kiváltó okát adja vissza. (Öröklődés forrása Exception)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Ha felül van bírálva egy származtatott osztályban, a SerializationInfo kivétel adatait adja meg. (Öröklődés forrása Exception)
GetType()	Lekéri az aktuális példány futtatókörnyezeti típusát. (Öröklődés forrása Exception)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Létrehozza és visszaadja az aktuális kivétel sztring-ábrázolását. (Öröklődés forrása Exception)

esemény

Name	Description
SerializeObjectState	Elavult. Akkor fordul elő, ha a kivétel szerializálva van egy kivételállapot-objektum létrehozásához, amely szerializált adatokat tartalmaz a kivételről. (Öröklődés forrása Exception)

Lásd még

• Thread
• Abort(Object)
• Szálak megsemmisítése