ThreadStateException Osztály

Definíció

Névtér:

System.Threading

Szerelvények:

netstandard.dll, System.Threading.Thread.dll

Forrás:

ThreadStateException.cs

Az a kivétel, amely akkor fordul elő, ha egy Thread metódushívás érvénytelen ThreadState .

public ref class ThreadStateException : SystemException

public class ThreadStateException : SystemException

type ThreadStateException = class
    inherit SystemException

Public Class ThreadStateException
Inherits SystemException

Öröklődés

Object

Exception

SystemException

ThreadStateException

Példák

Az alábbi példa egy hibát mutat be, amely miatt a rendszer egy 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

Ez a kód a következő kimenetet állítja elő:

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

Megjegyzések

Miután létrejött egy szál, legalább az egyik ThreadState állapotban van, amíg le nem fejeződik. ThreadStateException olyan metódusok dobják, amelyek nem tudják végrehajtani a kért műveletet a szál aktuális állapota miatt. Például egy megszakított szál újraindítása egy megszakított Startszál meghívásávalThreadStateException.

ThreadStateException A HRESULT COR_E_THREADSTATE használja, amelynek értéke 0x80131520.

A ThreadStateException példány kezdeti tulajdonságainak listájáért tekintse meg a ThreadStateException konstruktorokat.

Konstruktorok

Name	Description
ThreadStateException()	Inicializálja az osztály új példányát ThreadStateException alapértelmezett tulajdonságokkal.
ThreadStateException(SerializationInfo, StreamingContext)	Elavult. Inicializálja az ThreadStateException osztály új példányát szerializált adatokkal.
ThreadStateException(String, Exception)	Inicializálja az ThreadStateException osztály új példányát egy megadott hibaüzenettel és a kivétel okaként szolgáló belső kivételre mutató hivatkozással.
ThreadStateException(String)	Inicializálja az ThreadStateException osztály új példányát egy megadott hibaüzenettel.

Tulajdonságok

Name	Description
Data	Lekéri a kulcs-/érték párok gyűjteményét, amelyek további, felhasználó által definiált információkat biztosítanak a kivételről. (Öröklődés forrása Exception)
HelpLink	Lekéri vagy beállítja a kivételhez társított súgófájlra mutató hivatkozást. (Öröklődés forrása Exception)
HResult	Lekéri vagy beállítja a HRESULT-ot, egy kódolt numerikus értéket, amely egy adott kivételhez van hozzárendelve. (Öröklődés forrása Exception)
InnerException	Lekéri az Exception aktuális kivételt okozó példányt. (Öröklődés forrása Exception)
Message	Az aktuális kivételt leíró üzenet jelenik meg. (Öröklődés forrása Exception)
Source	Lekéri vagy beállítja az alkalmazás vagy a hibát okozó objektum nevét. (Öröklődés forrása Exception)
StackTrace	Lekéri a hívásverem közvetlen kereteinek sztringképét. (Öröklődés forrása Exception)
TargetSite	Lekéri az aktuális kivételt okozó metódust. (Öröklődés forrása Exception)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBaseException()	Ha egy származtatott osztály felül van bírálva, egy Exception vagy több későbbi kivétel kiváltó okát adja vissza. (Öröklődés forrása Exception)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Ha felül van bírálva egy származtatott osztályban, a SerializationInfo kivétel adatait adja meg. (Öröklődés forrása Exception)
GetType()	Lekéri az aktuális példány futtatókörnyezeti típusát. (Öröklődés forrása Exception)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Létrehozza és visszaadja az aktuális kivétel sztring-ábrázolását. (Öröklődés forrása Exception)

esemény

Name	Description
SerializeObjectState	Elavult. Akkor fordul elő, ha a kivétel szerializálva van egy kivételállapot-objektum létrehozásához, amely szerializált adatokat tartalmaz a kivételről. (Öröklődés forrása Exception)

Lásd még

• Thread
• ThreadState
• Exception
• Kivételek kezelése és kivetése a .NET-ben