ThreadAbortException Clase

Definición

Espacio de nombres:

System.Threading

Ensamblados:

netstandard.dll, System.Threading.Thread.dll

Source:

ThreadAbortException.cs

Excepción que se produce cuando se realiza una llamada al Abort(Object) método . Esta clase no puede heredarse.

public ref class ThreadAbortException sealed : SystemException

public sealed class ThreadAbortException : SystemException

type ThreadAbortException = class
    inherit SystemException

Public NotInheritable Class ThreadAbortException
Inherits SystemException

Herencia

Object

Exception

SystemException

ThreadAbortException

Ejemplos

En el ejemplo siguiente se muestra cómo anular un subproceso. El subproceso que recibe ThreadAbortException usa el ResetAbort método para cancelar la solicitud de anulación y continuar ejecutándose.

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

Este código genera la siguiente salida:

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.

Comentarios

Cuando se realiza una llamada al Abort método para destruir un subproceso, Common Language Runtime inicia una ThreadAbortException excepción en .NET Framework. ThreadAbortException es una excepción especial que se puede detectar, pero se volverá a generar automáticamente al final del catch bloque. Cuando se produce esta excepción, el tiempo de ejecución ejecuta todos los finally bloques antes de finalizar el subproceso. Dado que el subproceso puede realizar un cálculo sin enlazar en los finally bloques o llamar Thread.ResetAbort a para cancelar la anulación, no hay ninguna garantía de que el subproceso finalice nunca. Si desea esperar hasta que finalice el subproceso anulado, puede llamar al Thread.Join método . Join es una llamada de bloqueo que no devuelve hasta que el subproceso deja de ejecutarse.

Nota:

Solo .NET Core y .NET 5+: Aunque este tipo existe en .NET Core y .NET 5+, ya que Abort no se admite, Common Language Runtime nunca iniciará ThreadAbortException.

Nota:

Cuando Common Language Runtime (CLR) detiene los subprocesos en segundo plano una vez finalizados todos los subprocesos en primer plano de un archivo ejecutable administrado, no usa Thread.Abort. Por lo tanto, no se puede usar ThreadAbortException para detectar cuándo clR finaliza los subprocesos en segundo plano.

ThreadAbortException usa HRESULT COR_E_THREADABORTED, que tiene el valor 0x80131530.

Nota:

El valor de la propiedad heredada Data siempre nulles .

Propiedades

Nombre	Description
Data	Obtiene una colección de pares clave-valor que proporcionan información adicional definida por el usuario sobre la excepción. (Heredado de Exception)
ExceptionState	Obtiene un objeto que contiene información específica de la aplicación relacionada con la anulación del subproceso.
HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Heredado de Exception)
HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Heredado de Exception)
InnerException	Obtiene la Exception instancia que provocó la excepción actual. (Heredado de Exception)
Message	Obtiene un mensaje que describe la excepción actual. (Heredado de Exception)
Source	Obtiene o establece el nombre de la aplicación o el objeto que provoca el error. (Heredado de Exception)
StackTrace	Obtiene una representación de cadena de los fotogramas inmediatos en la pila de llamadas. (Heredado de Exception)
TargetSite	Obtiene el método que produce la excepción actual. (Heredado de Exception)

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetBaseException()	Cuando se reemplaza en una clase derivada, devuelve la Exception causa principal de una o varias excepciones posteriores. (Heredado de Exception)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obsoletos. Cuando se reemplaza en una clase derivada, establece con SerializationInfo información sobre la excepción. (Heredado de Exception)
GetType()	Obtiene el tipo de tiempo de ejecución de la instancia actual. (Heredado de Exception)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Crea y devuelve una representación de cadena de la excepción actual. (Heredado de Exception)

Eventos

Nombre	Description
SerializeObjectState	Obsoletos. Se produce cuando se serializa una excepción para crear un objeto de estado de excepción que contiene datos serializados sobre la excepción. (Heredado de Exception)

Consulte también

• Thread
• Abort(Object)
• Destrucción de subprocesos