Destroying Threads
The Abort method is used to stop a managed thread permanently. When you call Abort, the common language runtime throws a ThreadAbortException in the target thread, which the target thread can catch. For more information, see System.Threading.Thread.Abort.
.gif) Note |
|---|
If a thread is executing unmanaged code when its Abort method is called, the runtime marks it System.Threading.ThreadState.AbortRequested. The exception is thrown when the thread returns to managed code. |
Once a thread is aborted, it cannot be restarted.
The Abort method does not cause the thread to abort immediately, because the target thread can catch the ThreadAbortException and execute arbitrary amounts of code in a finally block. You can call System.Threading.Thread.Join if you need to wait until the thread has ended. System.Threading.Thread.Join is a blocking call that does not return until the thread has actually stopped executing or an optional timeout interval has elapsed. The aborted thread could call the ResetAbort method or perform unbounded processing in a finally block, so if you do not specify a timeout, the wait is not guaranteed to end.
Threads that are waiting on a call to the System.Threading.Thread.Join method can be interrupted by other threads that call System.Threading.Thread.Interrupt.
Handling ThreadAbortException
If you expect your thread to be aborted, either as a result of calling Abort from your own code or as a result of unloading an application domain in which the thread is running (System.AppDomain.Unload(System.AppDomain) uses System.Threading.Thread.Abort to terminate threads), your thread must handle the ThreadAbortException and perform any final processing in a finally clause, as shown in the following code.
Try
' Code that is executing when the thread is aborted.
Catch ex As ThreadAbortException
' Clean-up code can go here.
' If there is no Finally clause, ThreadAbortException is
' re-thrown by the system at the end of the Catch clause.
Finally
' Clean-up code can go here.
End Try
' Do not put clean-up code here, because the exception
' is rethrown at the end of the Finally clause.
try
{
// Code that is executing when the thread is aborted.
}
catch (ThreadAbortException ex)
{
// Clean-up code can go here.
// If there is no Finally clause, ThreadAbortException is
// re-thrown by the system at the end of the Catch clause.
}
// Do not put clean-up code here, because the exception
// is rethrown at the end of the Finally clause.
Your clean-up code must be in the catch clause or the finally clause, because a ThreadAbortException is rethrown by the system at the end of the finally clause, or at the end of the catch clause if there is no finally clause.
You can prevent the system from rethrowing the exception by calling the System.Threading.Thread.ResetAbort method. However, you should do this only if your own code caused the ThreadAbortException.