Thread.Abort Метод

Определение

Вызывает исключение ThreadAbortException в вызвавшем его потоке для того, чтобы начать процесс завершения потока.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread. Вызов данного метода обычно завершает поток.Calling this method usually terminates the thread.

Перегрузки

Abort()

Вызывает исключение ThreadAbortException в вызвавшем его потоке для того, чтобы начать процесс завершения потока.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread. Вызов данного метода обычно завершает поток.Calling this method usually terminates the thread.

Abort(Object)

Вызывает исключение ThreadAbortException в вызвавшем его потоке для того, чтобы начать процесс завершения потока, в то же время предоставляя сведения об исключении касательно исключения завершения потока.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. Вызов данного метода обычно завершает поток.Calling this method usually terminates the thread.

Комментарии

Важно!

Метод Thread.Abort следует использовать с осторожностью.The Thread.Abort method should be used with caution. Особенно при вызове метода для прерывания потока, отличного от текущего потока, неизвестно, какой код выполнялся или не удалось выполнить при возникновении ThreadAbortException, а также не может быть уверенным в состоянии приложения, а также о том, какое приложение и состояние пользователя респон сибле для сохранения.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. Например, вызов Thread.Abort может препятствовать выполнению статических конструкторов или помешать выпуску неуправляемых ресурсов.For example, calling Thread.Abort may prevent static constructors from executing or prevent the release of unmanaged resources.

Обратите внимание, что метод Thread.Abort не поддерживается в .NET Core.Note that the Thread.Abort method is not supported on .NET Core.

Abort()

Вызывает исключение ThreadAbortException в вызвавшем его потоке для того, чтобы начать процесс завершения потока.Raises a ThreadAbortException in the thread on which it is invoked, to begin the process of terminating the thread. Вызов данного метода обычно завершает поток.Calling this method usually terminates the thread.

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

Исключения

Только в .NET Core: этот элемент не поддерживается..NET Core only: This member is not supported.

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Поток, который прерывается, в настоящий момент приостановлен.The thread that is being aborted is currently suspended.

Комментарии

При вызове этого метода для потока система создает исключение ThreadAbortException в потоке для его прерывания.When this method is invoked on a thread, the system throws a ThreadAbortException in the thread to abort it. ThreadAbortException — это специальное исключение, которое может быть перехвачено кодом приложения, но повторно создается в конце блока catch, если не вызывается ResetAbort.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 отменяет запрос на прерывание и предотвращает остановку потока ThreadAbortException.ResetAbort cancels the request to abort, and prevents the ThreadAbortException from terminating the thread. Невыполненные блоки finally выполняются до отмены потока.Unexecuted finally blocks are executed before the thread is aborted.

Примечание

Когда поток вызывает Abort на самом себе, этот результат похож на создание исключения. ThreadAbortException происходит немедленно, и результат является прогнозируемым.When a thread calls Abort on itself, the effect is similar to throwing an exception; the ThreadAbortException happens immediately, and the result is predictable. Однако если один поток вызывает Abort в другом потоке, прерывание прерывает выполнение любого кода.However, if one thread calls Abort on another thread, the abort interrupts whatever code is running. Существует также вероятность прерывания статического конструктора.There is also a chance that a static constructor could be aborted. В редких случаях это может препятствовать созданию экземпляров этого класса в этом домене приложения.In rare cases, this might prevent instances of that class from being created in that application domain. В .NET Framework версиях 1,0 и 1,1 существует шанс, что поток может прерваться, пока выполняется блок finally, в этом случае блок finally будет прерван.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.

Поток не гарантирует немедленное прерывание или вообще.The thread is not guaranteed to abort immediately, or at all. Такая ситуация может возникнуть, если поток выполняет неограниченное количество вычислений в блоках finally, которые вызываются как часть процедуры прерывания, тем самым бесконечно откладывая прерывание.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. Чтобы подождать, пока поток не будет прерван, можно вызвать метод Join в потоке после вызова метода Abort, но не гарантируется, что ожидание завершится.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.

Примечание

Поток, вызывающий Abort, может блокироваться, если поток, для которого выполняется прерывание, находится в защищенной области кода, например блок catch, блок finally или область ограниченного выполнения.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. Если поток, вызывающий Abort, удерживает блокировку, требуемую для прерванного потока, может возникнуть взаимоблокировка.If the thread that calls Abort holds a lock that the aborted thread requires, a deadlock can occur.

Если Abort вызывается в потоке, который не был запущен, поток будет прерван при вызове Start.If Abort is called on a thread that has not been started, the thread will abort when Start is called. Если Abort вызывается в потоке, который заблокирован или находится в режиме ожидания, поток прерывается, а затем прерывается.If Abort is called on a thread that is blocked or is sleeping, the thread is interrupted and then aborted.

Если для приостановленного потока вызывается Abort, в потоке, вызвавшем Abort, выдается ThreadStateException, а AbortRequested добавляется в свойство ThreadState потока, для которого выполняется прерывание.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. ThreadAbortException не создается в приостановленном потоке до вызова Resume.A ThreadAbortException is not thrown in the suspended thread until Resume is called.

Если Abort вызывается в управляемом потоке во время выполнения неуправляемого кода, ThreadAbortException не создается, пока поток не вернется в управляемый код.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.

Если два вызова Abort приходят в одно и то же время, один вызов может установить сведения о состоянии и другой вызов для выполнения 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. Однако приложение не может обнаружить такую ситуацию.However, an application cannot detect this situation.

После вызова Abort в потоке состояние потока включает AbortRequested.After Abort is invoked on a thread, the state of the thread includes AbortRequested. После того как поток завершился в результате успешного вызова Abort, состояние потока изменяется на Stopped.After the thread has terminated as a result of a successful call to Abort, the state of the thread is changed to Stopped. При наличии достаточных разрешений поток, являющийся целью Abort, может отменить прерывание с помощью метода ResetAbort.With sufficient permissions, a thread that is the target of an Abort can cancel the abort using the ResetAbort method. Пример, демонстрирующий вызов метода ResetAbort, см. в разделе класс ThreadAbortException.For an example that demonstrates calling the ResetAbort method, see the ThreadAbortException class.

Безопасность

SecurityPermission
для расширенных операций с потоками.for advanced operations on threads. Связанное перечисление: ControlThread.Associated enumeration: ControlThread.

Дополнительно

Abort(Object)

Вызывает исключение ThreadAbortException в вызвавшем его потоке для того, чтобы начать процесс завершения потока, в то же время предоставляя сведения об исключении касательно исключения завершения потока.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. Вызов данного метода обычно завершает поток.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)

Параметры

stateInfo
Object

Объект, который содержит информацию об определенном приложении, например состояние, которое может использоваться аварийно завершающимся потоком.An object that contains application-specific information, such as state, which can be used by the thread being aborted.

Исключения

Только в .NET Core: этот элемент не поддерживается..NET Core only: This member is not supported.

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Поток, который прерывается, в настоящий момент приостановлен.The thread that is being aborted is currently suspended.

Примеры

В следующем примере кода показано, как передать сведения в поток, который будет прерван.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.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

Комментарии

При вызове этого метода для потока система создает исключение ThreadAbortException в потоке для его прерывания.When this method is invoked on a thread, the system throws a ThreadAbortException in the thread to abort it. ThreadAbortException — это специальное исключение, которое может быть перехвачено кодом приложения, но повторно создается в конце блока catch, если не вызывается ResetAbort.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 отменяет запрос на прерывание и предотвращает остановку потока ThreadAbortException.ResetAbort cancels the request to abort, and prevents the ThreadAbortException from terminating the thread. Невыполненные блоки finally выполняются до отмены потока.Unexecuted finally blocks are executed before the thread is aborted.

Примечание

Когда поток вызывает Abort на самом себе, этот результат похож на создание исключения. ThreadAbortException происходит немедленно, и результат является прогнозируемым.When a thread calls Abort on itself, the effect is similar to throwing an exception; the ThreadAbortException happens immediately, and the result is predictable. Однако если один поток вызывает Abort в другом потоке, прерывание прерывает выполнение любого кода.However, if one thread calls Abort on another thread, the abort interrupts whatever code is running. Существует вероятность прерывания статического конструктора.There is a chance that a static constructor could be aborted. В редких случаях это может препятствовать созданию экземпляров этого класса в этом домене приложения.In rare cases, this might prevent instances of that class from being created in that application domain. В .NET Framework версиях 1,0 и 1,1 существует шанс, что поток может прерваться, пока выполняется блок finally, в этом случае блок finally будет прерван.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.

Поток не гарантирует немедленное прерывание или вообще.The thread is not guaranteed to abort immediately, or at all. Такая ситуация может возникнуть, если поток выполняет неограниченное количество вычислений в блоках finally, которые вызываются как часть процедуры прерывания, тем самым бесконечно откладывая прерывание.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. Чтобы подождать, пока поток не будет прерван, можно вызвать метод Join в потоке после вызова метода Abort, но нет никакой гарантии, что ожидание завершится.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.

Примечание

Поток, вызывающий Abort, может блокироваться, если поток, для которого выполняется прерывание, находится в защищенной области кода, например блок catch, блок finally или область ограниченного выполнения.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. Если поток, вызывающий Abort, удерживает блокировку, требуемую для прерванного потока, может возникнуть взаимоблокировка.If the thread that calls Abort holds a lock that the aborted thread requires, a deadlock can occur.

Если Abort вызывается в потоке, который не был запущен, поток будет прерван при вызове Start.If Abort is called on a thread that has not been started, the thread will abort when Start is called. Если Abort вызывается в потоке, который заблокирован или находится в режиме ожидания, поток прерывается, а затем прерывается.If Abort is called on a thread that is blocked or is sleeping, the thread is interrupted and then aborted.

Если для приостановленного потока вызывается Abort, в потоке, вызвавшем Abort, выдается ThreadStateException, а AbortRequested добавляется в свойство ThreadState потока, для которого выполняется прерывание.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. ThreadAbortException не создается в приостановленном потоке до вызова Resume.A ThreadAbortException is not thrown in the suspended thread until Resume is called.

Если Abort вызывается в управляемом потоке во время выполнения неуправляемого кода, ThreadAbortException не создается, пока поток не вернется в управляемый код.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.

Если два вызова Abort приходят в одно и то же время, один вызов может установить сведения о состоянии и другой вызов для выполнения 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. Однако приложение не может обнаружить такую ситуацию.However, an application cannot detect this situation.

После вызова Abort в потоке состояние потока включает AbortRequested.After Abort is invoked on a thread, the state of the thread includes AbortRequested. После того как поток завершился в результате успешного вызова Abort, состояние потока изменяется на Stopped.After the thread has terminated as a result of a successful call to Abort, the state of the thread is changed to Stopped. При наличии достаточных разрешений поток, являющийся целью Abort, может отменить прерывание с помощью метода ResetAbort.With sufficient permissions, a thread that is the target of an Abort can cancel the abort using the ResetAbort method. Пример, демонстрирующий вызов метода ResetAbort, см. в разделе класс ThreadAbortException.For an example that demonstrates calling the ResetAbort method, see the ThreadAbortException class.

Безопасность

SecurityPermission
для расширенных операций с потоками.for advanced operations on threads. Связанное перечисление: ControlThread.Associated enumeration: ControlThread.

Дополнительно

Применяется к