ThreadStateException Classe

Definição

public ref class ThreadStateException : SystemException

[System.Serializable]
public class ThreadStateException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ThreadStateException : SystemException

public class ThreadStateException : SystemException

[<System.Serializable>]
type ThreadStateException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ThreadStateException = class
    inherit SystemException

type ThreadStateException = class
    inherit SystemException

Public Class ThreadStateException
Inherits SystemException

Herança

Object

Exception

SystemException

ThreadStateException

Atributos

SerializableAttribute ComVisibleAttribute

Exemplos

O exemplo seguinte demonstra um erro que faz o sistema lançar um ThreadStateException.

using System;
using System.Threading;

public class ThreadWork
{
   public static void DoWork()
   {
      Console.WriteLine("Working thread...");
   }
}

class ThreadStateTest
{
   public static void Main()
   {
      ThreadStart myThreadDelegate = new ThreadStart(ThreadWork.DoWork);
      Thread myThread = new Thread(myThreadDelegate);
      myThread.Start();
      Thread.Sleep(0);
      Console.WriteLine("In main. Attempting to restart myThread.");
      try
      {
         myThread.Start();
      }
      catch (ThreadStateException e)
      {
         Console.WriteLine("Caught: {0}", e.Message);
      }
   }
}

Imports System.Threading

Public Class ThreadWork
   
   Public Shared Sub DoWork()
      Console.WriteLine("Working thread...")
   End Sub
End Class

Class ThreadStateTest
   
   Public Shared Sub Main()
      Dim myThreadDelegate As New ThreadStart(AddressOf ThreadWork.DoWork)
      Dim myThread As New Thread(myThreadDelegate)
      myThread.Start()
      Thread.Sleep(0)
      Console.WriteLine("In main. Attempting to restart myThread.")
      Try
         myThread.Start()
      Catch e As ThreadStateException
         Console.WriteLine("Caught: {0}", e.Message)
      End Try
   End Sub
End Class

Este código gera o seguinte resultado:

In main. Attempting to restart myThread.
    Working thread...
    Caught: Thread is running or terminated. Cannot restart.

Observações

Uma vez criada uma thread, ela permanece em pelo menos um dos ThreadState estados até terminar. ThreadStateException é lançado por métodos que não conseguem realizar a operação solicitada devido ao estado atual de uma thread. Por exemplo, tentar reiniciar uma thread abortada chamando Start uma thread que terminou gera um ThreadStateException.

ThreadStateException utiliza o COR_E_THREADSTATE HRESULT, que tem o valor 0x80131520.

Para obter uma lista dos valores iniciais de propriedade de uma instância de ThreadStateException, consulte os construtores de ThreadStateException.

Ver também

• Thread
• ThreadState
• Exception
• Manipulando e lançando exceções no .NET