ThreadStateException Třída

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.Thread.dll

Zdroj:

ThreadStateException.cs

Výjimka, která je vyvolán v případě Thread , že je pro volání metody neplatný ThreadState .

public ref class ThreadStateException : SystemException

public class ThreadStateException : SystemException

type ThreadStateException = class
    inherit SystemException

Public Class ThreadStateException
Inherits SystemException

Dědičnost

Object

Exception

SystemException

ThreadStateException

Příklady

Následující příklad ukazuje chybu, která způsobí, že systém vyvolá 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

Tento kód vytvoří následující výstup:

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

Poznámky

Jakmile se vlákno vytvoří, je v alespoň jednom ze ThreadState stavů, dokud se neukončí. ThreadStateException je vyvolána metodami, které nemohou provést požadovanou operaci z důvodu aktuálního stavu vlákna. Například pokus o restartování přerušeného vlákna voláním Start na vlákno, které ukončilo vyvolá ThreadStateExceptionvýjimku .

ThreadStateException používá COR_E_THREADSTATE HRESULT, který má hodnotu 0x80131520.

Seznam počátečních hodnot vlastností pro instanci ThreadStateExceptionnaleznete v konstruktoru ThreadStateException.

Konstruktory

Name	Description
ThreadStateException()	Inicializuje novou instanci ThreadStateException třídy s výchozími vlastnostmi.
ThreadStateException(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci ThreadStateException třídy serializovanými daty.
ThreadStateException(String, Exception)	Inicializuje novou instanci ThreadStateException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.
ThreadStateException(String)	Inicializuje novou instanci ThreadStateException třídy se zadanou chybovou zprávou.

Vlastnosti

Name	Description
Data	Získá kolekci párů klíč/hodnota, které poskytují další uživatelem definované informace o výjimce. (Zděděno od Exception)
HelpLink	Získá nebo nastaví odkaz na soubor nápovědy přidružený k této výjimce. (Zděděno od Exception)
HResult	Získá nebo nastaví HRESULT, kódovanou číselnou hodnotu, která je přiřazena ke konkrétní výjimce. (Zděděno od Exception)
InnerException	Exception Získá instanci, která způsobila aktuální výjimku. (Zděděno od Exception)
Message	Získá zprávu, která popisuje aktuální výjimku. (Zděděno od Exception)
Source	Získá nebo nastaví název aplikace nebo objektu, který způsobuje chybu. (Zděděno od Exception)
StackTrace	Získá řetězcové znázornění okamžitých rámců v zásobníku volání. (Zděděno od Exception)
TargetSite	Získá metodu, která vyvolá aktuální výjimku. (Zděděno od Exception)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception to, že je původní příčinou jedné nebo více následných výjimek. (Zděděno od Exception)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Při přepsání v odvozené třídě nastaví SerializationInfo s informacemi o výjimce. (Zděděno od Exception)
GetType()	Získá typ modulu runtime aktuální instance. (Zděděno od Exception)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vytvoří a vrátí řetězcovou reprezentaci aktuální výjimky. (Zděděno od Exception)

Událost

Name	Description
SerializeObjectState	Zastaralé. Nastane, když je výjimka serializována vytvořit objekt stavu výjimky, který obsahuje serializovaná data o výjimce. (Zděděno od Exception)

Viz také

• Thread
• ThreadState
• Exception
• Zpracování a vyvolání výjimek v .NET