ThreadStateException Třída

Reference

Definice

Obor názvů:: System.Threading

Sestavení:: System.Threading.Thread.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

public ref class ThreadStateException : SystemException

public ref class ThreadStateException : Exception

public class ThreadStateException : SystemException

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

[System.Serializable]
public class ThreadStateException : SystemException

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

type ThreadStateException = class
    inherit SystemException

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

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

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

Public Class ThreadStateException
Inherits SystemException

Public Class ThreadStateException
Inherits Exception

Dědičnost: Object

Exception

SystemException
ThreadStateException

Dědičnost: Object

Exception
ThreadStateException

Atributy: ComVisibleAttribute SerializableAttribute

Příklady

Následující příklad ukazuje chybu, která způsobí, že systém vyvolá ThreadStateException.

using namespace System;
using namespace System::Threading;
ref class ThreadWork
{
public:
   static void DoWork()
   {
      Console::WriteLine( "Working thread..." );
   }

};

int main()
{
   ThreadStart^ myThreadDelegate = gcnew ThreadStart( ThreadWork::DoWork );
   Thread^ myThread = gcnew 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 );
   }

}

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

Výsledkem tohoto kódu je 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ří, bude alespoň v jednom ze ThreadState stavů, dokud se ukončí. ThreadStateException je vyvolána metodami, které nemohou provést požadovanou operaci kvůli aktuálnímu 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 ThreadStateExceptionvyvolá chybu .

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

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

Konstruktory

ThreadStateException()	Inicializuje novou instanci ThreadStateException třídy s výchozími vlastnostmi.
ThreadStateException(SerializationInfo, StreamingContext)	Inicializuje novou instanci třídy ThreadStateException se serializovanými daty.
ThreadStateException(String)	Inicializuje novou instanci třídy se zadanou chybovou ThreadStateException zprávou.
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.

Vlastnosti

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 přiřazenou 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

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBaseException()	Při přepsání v odvozené třídě vrátí Exception hodnotu, která je hlavní 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)	Při přepsání v odvozené třídě nastaví s SerializationInfo 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ří použádnou kopii aktuálního souboru 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

SerializeObjectState

Zastaralé.

Nastane, když je výjimka serializována k vytvoření objektu stavu výjimky, který obsahuje serializovaná data o výjimce.

(Zděděno od Exception)

Platí pro