Thread.Abort Thread.Abort Thread.Abort Thread.Abort Method

Definition

Löst eine ThreadAbortException im Thread aus, für den der Aufruf erfolgte, um das Beenden des Threads zu beginnen.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread. Durch den Aufruf dieser Methode wird der Thread i. d. R. beendet.Calling this method usually terminates the thread.

Überlädt

Abort() Abort() Abort() Abort()

Löst eine ThreadAbortException im Thread aus, für den der Aufruf erfolgte, um das Beenden des Threads zu beginnen.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread. Durch den Aufruf dieser Methode wird der Thread i. d. R. beendet.Calling this method usually terminates the thread.

Abort(Object) Abort(Object) Abort(Object) Abort(Object)

Löst eine ThreadAbortException im Thread aus, für den der Aufruf erfolgte, um das Beenden des Threads zu beginnen. Gleichzeitig werden Ausnahmeinformationen über das Beenden des Threads bereitgestellt.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread while also providing exception information about the thread termination. Durch den Aufruf dieser Methode wird der Thread i. d. R. beendet.Calling this method usually terminates the thread.

Hinweise

Wichtig

Die Thread.Abort Methode sollte mit Vorsicht verwendet werden.The Thread.Abort method should be used with caution. Insbesondere dann, wenn Sie sie zum Abbrechen von eines anderen Threads als dem aktuellen Thread aufrufen, Sie nicht wissen, welcher Code ausgeführt hat, oder konnte nicht ausgeführt wird, wenn die ThreadAbortException ausgelöst wird, noch können Sie bestimmte des Zustands der Anwendung oder eine beliebige Anwendung und dem angegebenen Benutzerzustand, die verantwortlich für das beibehalten.Particularly when you call it to abort a thread other than the current thread, you do not know what code has executed or failed to execute when the ThreadAbortException is thrown, nor can you be certain of the state of your application or any application and user state that it is responsible for preserving. Zum Beispiel der Aufruf Thread.Abort möglicherweise verhindert, dass statische Konstruktoren ausgeführt oder zu verhindern, dass die Freigabe von nicht verwalteten Ressourcen.For example, calling Thread.Abort may prevent static constructors from executing or prevent the release of unmanaged resources.

Beachten Sie, dass die Thread.Abort Methode wird in .NET Core nicht unterstützt.Note that the Thread.Abort method is not supported on .NET Core.

Abort() Abort() Abort() Abort()

Löst eine ThreadAbortException im Thread aus, für den der Aufruf erfolgte, um das Beenden des Threads zu beginnen.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread. Durch den Aufruf dieser Methode wird der Thread i. d. R. beendet.Calling this method usually terminates the thread.

public:
 void Abort();
public void Abort ();
member this.Abort : unit -> unit
Public Sub Abort ()

Ausnahmen

Nur .NET Core: Dieser Member wird nicht unterstützt..NET Core only: This member is not supported.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Der abgebrochene Thread ist derzeit angehalten.The thread that is being aborted is currently suspended.

Hinweise

Wenn diese Methode in einem Thread aufgerufen wird, löst das System eine ThreadAbortException im Thread aus, um ihn abzubrechen.When this method is invoked on a thread, the system throws a ThreadAbortException in the thread to abort it. ThreadAbortException ist eine besondere Ausnahme, die vom Anwendungscode abgefangen werden kann, jedoch wird erneut ausgelöst wird, am Ende der catch blockieren, wenn ResetAbort aufgerufen wird.ThreadAbortException is a special exception that can be caught by application code, but is re-thrown at the end of the catch block unless ResetAbort is called. ResetAbort Bricht die Anforderung abbricht, ab und verhindert, dass die ThreadAbortException aus Beenden des Threads.ResetAbort cancels the request to abort, and prevents the ThreadAbortException from terminating the thread. Nicht ausgeführte finally -Blöcke werden vor dem Abbruch des Threads ausgeführt.Unexecuted finally blocks are executed before the thread is aborted.

Hinweis

Wenn ein Thread ruft Abort für sich selbst, die Wirkung gleicht dem Auslösen einer Ausnahme, die ThreadAbortException erfolgt sofort, und das Ergebnis ist vorhersagbar.When a thread calls Abort on itself, the effect is similar to throwing an exception; the ThreadAbortException happens immediately, and the result is predictable. Aber wenn ein Thread ruft Abort in einem anderen Thread unterbricht der Abbruch jeden beliebigen Code ausgeführt wird.However, if one thread calls Abort on another thread, the abort interrupts whatever code is running. Es ist auch möglich, dass ein statischer Konstruktor kann abgebrochen werden.There is also a chance that a static constructor could be aborted. In seltenen Fällen kann dies verhindern, dass Instanzen dieser Klasse, die in dieser Anwendungsdomäne erstellt wird.In rare cases, this might prevent instances of that class from being created in that application domain. In der .NET Framework-Versionen 1.0 und 1.1, besteht die Möglichkeit den Thread abzubrechen konnte. während einer finally Block ausgeführt wird, in diesem Fall die finally abgebrochen wird.In the .NET Framework versions 1.0 and 1.1, there is a chance the thread could abort while a finally block is running, in which case the finally block is aborted.

Der Thread ist nicht garantiert, sofort oder überhaupt abgebrochen.The thread is not guaranteed to abort immediately, or at all. Diese Situation kann auftreten, wenn ein Thread eine ungebundene Menge, der Berechnung in der Fall ist die finally Blöcke, die als Teil der Abort-Prozedur, die der Abbruch dadurch auf unbestimmte Zeit verzögert aufgerufen werden.This situation can occur if a thread does an unbounded amount of computation in the finally blocks that are called as part of the abort procedure, thereby indefinitely delaying the abort. Um warten, bis ein Thread abgebrochen wurde, rufen Sie die Join Methode für den Thread nach dem Aufruf der Abort -Methode, aber es gibt keine Garantie der Wartevorgang wird beendet.To wait until a thread has aborted, you can call the Join method on the thread after calling the Abort method, but there is no guarantee the wait will end.

Hinweis

Der aufrufende Thread Abort möglicherweise blockiert, wenn der Thread, die abgebrochen wird in einen geschützten Codebereich, z. B. eine catch Block finally Block oder eingeschränkten Ausführungsbereich.The thread that calls Abort might block if the thread that is being aborted is in a protected region of code, such as a catch block, finally block, or constrained execution region. Wenn der Thread aufruft Abort eine Sperre, die der abgebrochene Thread erforderlich ist, kann ein Deadlock auftreten, enthält.If the thread that calls Abort holds a lock that the aborted thread requires, a deadlock can occur.

Wenn Abort wird aufgerufen, in einem Thread, der nicht gestartet wurde, wird den Thread abzubrechen Wenn Start aufgerufen wird.If Abort is called on a thread that has not been started, the thread will abort when Start is called. Wenn Abort wird aufgerufen, in einem Thread, der blockiert ist oder im Ruhezustand, der Thread unterbrochen wird, und dann abgebrochen.If Abort is called on a thread that is blocked or is sleeping, the thread is interrupted and then aborted.

Wenn Abort für einen Thread, der angehalten wurde, aufgerufen wird eine ThreadStateException wird ausgelöst, in dem Thread, Abort, und AbortRequested hinzugefügt wird die ThreadState Eigenschaft des Threads wird abgebrochen.If Abort is called on a thread that has been suspended, a ThreadStateException is thrown in the thread that called Abort, and AbortRequested is added to the ThreadState property of the thread being aborted. Ein ThreadAbortException wird nicht ausgelöst, in den angehaltenen Thread, bis Resume aufgerufen wird.A ThreadAbortException is not thrown in the suspended thread until Resume is called.

Wenn Abort für einen verwalteten Thread aufgerufen wird, während er nicht verwalteten Code ausführt, wird eine ThreadAbortException wird nicht ausgelöst, bis der Thread zu verwaltetem Code zurückkehrt.If Abort is called on a managed thread while it is executing unmanaged code, a ThreadAbortException is not thrown until the thread returns to managed code.

Wenn zwei Aufrufe Abort kommen zur gleichen Zeit, es ist möglich, dass ein Aufruf zum Festlegen von Informationen über den Zustand und der andere Aufruf zum Ausführen der Abort.If two calls to Abort come at the same time, it is possible for one call to set the state information and the other call to execute the Abort. Eine Anwendung kann nicht jedoch, diese Situation erkennen.However, an application cannot detect this situation.

Nach dem Abort wird aufgerufen, in einem Thread der Zustand des Threads enthält AbortRequested.After Abort is invoked on a thread, the state of the thread includes AbortRequested. Nachdem der Thread, als Ergebnis einer erfolgreichen Aufruf von beendet wurde Abort, der Status des Threads wird geändert, um Stopped.After the thread has terminated as a result of a successful call to Abort, the state of the thread is changed to Stopped. Ein Thread, der ist mit den entsprechenden Berechtigungen das Ziel einer Abort können abbrechen, diesen Vorgang unter Verwendung der ResetAbort Methode.With sufficient permissions, a thread that is the target of an Abort can cancel the abort using the ResetAbort method. Ein Beispiel zur Veranschaulichung von Aufrufen der ResetAbort -Methode finden Sie unter den ThreadAbortException Klasse.For an example that demonstrates calling the ResetAbort method, see the ThreadAbortException class.

Sicherheit

SecurityPermission
für erweiterte Vorgänge in Threads.for advanced operations on threads. Zugeordnete Enumeration: ControlThreadAssociated enumeration: ControlThread.

Siehe auch

Abort(Object) Abort(Object) Abort(Object) Abort(Object)

Löst eine ThreadAbortException im Thread aus, für den der Aufruf erfolgte, um das Beenden des Threads zu beginnen. Gleichzeitig werden Ausnahmeinformationen über das Beenden des Threads bereitgestellt.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread while also providing exception information about the thread termination. Durch den Aufruf dieser Methode wird der Thread i. d. R. beendet.Calling this method usually terminates the thread.

public:
 void Abort(System::Object ^ stateInfo);
public void Abort (object stateInfo);
member this.Abort : obj -> unit
Public Sub Abort (stateInfo As Object)

Parameter

stateInfo
Object Object Object Object

Ein Objekt, das anwendungsspezifische Informationen enthält (z. B. über den Zustand), die vom abgebrochenen Thread verwendet werden können.An object that contains application-specific information, such as state, which can be used by the thread being aborted.

Ausnahmen

Nur .NET Core: Dieser Member wird nicht unterstützt..NET Core only: This member is not supported.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Der abgebrochene Thread ist derzeit angehalten.The thread that is being aborted is currently suspended.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, Informationen an einen Thread zu übergeben, die abgebrochen wird.The following code example shows how to pass information to a thread that is being aborted.

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
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

Hinweise

Wenn diese Methode in einem Thread aufgerufen wird, löst das System eine ThreadAbortException im Thread aus, um ihn abzubrechen.When this method is invoked on a thread, the system throws a ThreadAbortException in the thread to abort it. ThreadAbortException ist eine besondere Ausnahme, die vom Anwendungscode abgefangen werden kann, jedoch wird erneut ausgelöst wird, am Ende der catch blockieren, wenn ResetAbort aufgerufen wird.ThreadAbortException is a special exception that can be caught by application code, but is re-thrown at the end of the catch block unless ResetAbort is called. ResetAbort Bricht die Anforderung abbricht, ab und verhindert, dass die ThreadAbortException aus Beenden des Threads.ResetAbort cancels the request to abort, and prevents the ThreadAbortException from terminating the thread. Nicht ausgeführte finally -Blöcke werden vor dem Abbruch des Threads ausgeführt.Unexecuted finally blocks are executed before the thread is aborted.

Hinweis

Wenn ein Thread ruft Abort für sich selbst, die Wirkung gleicht dem Auslösen einer Ausnahme, die ThreadAbortException erfolgt sofort, und das Ergebnis ist vorhersagbar.When a thread calls Abort on itself, the effect is similar to throwing an exception; the ThreadAbortException happens immediately, and the result is predictable. Aber wenn ein Thread ruft Abort in einem anderen Thread unterbricht der Abbruch jeden beliebigen Code ausgeführt wird.However, if one thread calls Abort on another thread, the abort interrupts whatever code is running. Es besteht die Möglichkeit, dass ein statischer Konstruktor kann abgebrochen werden.There is a chance that a static constructor could be aborted. In seltenen Fällen kann dies verhindern, dass Instanzen dieser Klasse, die in dieser Anwendungsdomäne erstellt wird.In rare cases, this might prevent instances of that class from being created in that application domain. In der .NET Framework-Versionen 1.0 und 1.1, besteht die Möglichkeit den Thread abzubrechen konnte. während einer finally Block ausgeführt wird, in diesem Fall die finally abgebrochen wird.In the .NET Framework versions 1.0 and 1.1, there is a chance the thread could abort while a finally block is running, in which case the finally block is aborted.

Der Thread ist nicht garantiert, sofort oder überhaupt abgebrochen.The thread is not guaranteed to abort immediately, or at all. Diese Situation kann auftreten, wenn ein Thread eine ungebundene Menge, der Berechnung in der Fall ist die finally Blöcke, die als Teil der Abort-Prozedur, die der Abbruch dadurch auf unbestimmte Zeit verzögert aufgerufen werden.This situation can occur if a thread does an unbounded amount of computation in the finally blocks that are called as part of the abort procedure, thereby indefinitely delaying the abort. Um warten, bis ein Thread abgebrochen wurde, rufen Sie die Join Methode für den Thread nach dem Aufruf der Abort -Methode, aber es gibt keine Garantie, die der Wartevorgang beendet wird.To wait until a thread has aborted, you can call the Join method on the thread after calling the Abort method, but there is no guarantee that the wait will end.

Hinweis

Der aufrufende Thread Abort möglicherweise blockiert, wenn der Thread, die abgebrochen wird in einen geschützten Codebereich, z. B. eine catch Block finally Block oder eingeschränkten Ausführungsbereich.The thread that calls Abort might block if the thread that is being aborted is in a protected region of code, such as a catch block, finally block, or constrained execution region. Wenn der Thread aufruft Abort eine Sperre, die der abgebrochene Thread erforderlich ist, kann ein Deadlock auftreten, enthält.If the thread that calls Abort holds a lock that the aborted thread requires, a deadlock can occur.

Wenn Abort wird aufgerufen, in einem Thread, der nicht gestartet wurde, wird den Thread abzubrechen Wenn Start aufgerufen wird.If Abort is called on a thread that has not been started, the thread will abort when Start is called. Wenn Abort wird aufgerufen, in einem Thread, der blockiert ist oder im Ruhezustand, der Thread unterbrochen wird, und dann abgebrochen.If Abort is called on a thread that is blocked or is sleeping, the thread is interrupted and then aborted.

Wenn Abort für einen Thread, der angehalten wurde, aufgerufen wird eine ThreadStateException wird ausgelöst, in dem Thread, Abort, und AbortRequested hinzugefügt wird die ThreadState Eigenschaft des Threads wird abgebrochen.If Abort is called on a thread that has been suspended, a ThreadStateException is thrown in the thread that called Abort, and AbortRequested is added to the ThreadState property of the thread being aborted. Ein ThreadAbortException wird nicht ausgelöst, in den angehaltenen Thread, bis Resume aufgerufen wird.A ThreadAbortException is not thrown in the suspended thread until Resume is called.

Wenn Abort für einen verwalteten Thread aufgerufen wird, während er nicht verwalteten Code ausführt, wird eine ThreadAbortException wird nicht ausgelöst, bis der Thread zu verwaltetem Code zurückkehrt.If Abort is called on a managed thread while it is executing unmanaged code, a ThreadAbortException is not thrown until the thread returns to managed code.

Wenn zwei Aufrufe Abort kommen zur gleichen Zeit, es ist möglich, dass ein Aufruf zum Festlegen von Informationen über den Zustand und der andere Aufruf zum Ausführen der Abort.If two calls to Abort come at the same time, it is possible for one call to set the state information and the other call to execute the Abort. Eine Anwendung kann nicht jedoch, diese Situation erkennen.However, an application cannot detect this situation.

Nach dem Abort wird aufgerufen, in einem Thread der Zustand des Threads enthält AbortRequested.After Abort is invoked on a thread, the state of the thread includes AbortRequested. Nachdem der Thread, als Ergebnis einer erfolgreichen Aufruf von beendet wurde Abort, der Status des Threads wird geändert, um Stopped.After the thread has terminated as a result of a successful call to Abort, the state of the thread is changed to Stopped. Ein Thread, der ist mit den entsprechenden Berechtigungen das Ziel einer Abort können abbrechen, diesen Vorgang unter Verwendung der ResetAbort Methode.With sufficient permissions, a thread that is the target of an Abort can cancel the abort using the ResetAbort method. Ein Beispiel zur Veranschaulichung von Aufrufen der ResetAbort -Methode finden Sie unter den ThreadAbortException Klasse.For an example that demonstrates calling the ResetAbort method, see the ThreadAbortException class.

Sicherheit

SecurityPermission
für erweiterte Vorgänge in Threads.for advanced operations on threads. Zugeordnete Enumeration: ControlThreadAssociated enumeration: ControlThread.

Siehe auch

Gilt für: