ThreadState-Enumeration

Gibt die Ausführungszustände eines Thread an.

Diese Enumeration verfügt über ein FlagsAttribute -Attribut, das die bitweise Kombination der Memberwerte zulässt.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<FlagsAttribute> _
Public Enumeration ThreadState
'Usage
Dim instance As ThreadState

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[FlagsAttribute] 
public enum ThreadState

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[FlagsAttribute] 
public enum class ThreadState

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute FlagsAttribute() */ 
public enum ThreadState

SerializableAttribute 
ComVisibleAttribute(true) 
FlagsAttribute 
public enum ThreadState

Member

	Membername	Beschreibung
	Aborted	Der Thread befindet sich im Stopped-Zustand.
	AbortRequested	Die Thread.Abort-Methode wurde für den Thread aufgerufen, doch der Thread hat noch nicht die ausstehende System.Threading.ThreadAbortException empfangen, die ihn zu beenden versucht.
	Background	Der Thread wird nicht als Vordergrundthread, sondern als Hintergrundthread ausgeführt. Dieser Zustand wird durch Festlegen der Thread.IsBackground-Eigenschaft gesteuert.
	Running	Der Thread wurde gestartet, er wird nicht blockiert, und es ist keine ausstehende ThreadAbortException vorhanden.
	Stopped	Der Thread wurde beendet.
	StopRequested	Es besteht eine Anforderung für die Beendigung des Threads. Dies ist ausschließlich für die interne Verwendung vorgesehen.
	Suspended	Der Thread wurde unterbrochen.
	SuspendRequested	Es besteht eine Anforderung für die Unterbrechung des Threads.
	Unstarted	Die Thread.Start-Methode wurde für den Thread nicht aufgerufen.
	WaitSleepJoin	Der Thread ist als Ergebnis eines Aufrufs von Wait, Sleep oder Join blockiert.

Hinweise

ThreadState definiert eine Gruppe aller möglichen Ausführungszustände für Threads. Ein Thread befindet sich nach seiner Erstellung bis zu seiner Beendigung in mindestens einem der Zustände. Innerhalb der Common Language Runtime erstellte Threads befinden sich anfangs im Unstarted-Zustand, während in die Runtime eintretende externe Threads sich bereits im Running-Zustand befinden. Ein Unstarted-Thread geht durch den Aufruf von Start in den Running-Zustand über. Es sind nicht alle Kombinationen von ThreadState-Werten gültig. Ein Thread kann sich z. B nicht gleichzeitig im Aborted-Zustand und im Unstarted-Zustand befinden.

Wichtig

Der Threadzustand ist nur in bestimmten Debugszenarien von Interesse. Code sollte den Threadzustand unter keinen Umständen zum Synchronisieren der Threadaktivität verwenden.

In der folgenden Tabelle sind die Aktionen aufgeführt, die eine Zustandsänderung bewirken.

Aktion	ThreadState
Ein Thread wird innerhalb der Common Language Runtime erstellt.	Unstarted
Ein Thread ruft Start auf.	Unstarted
Die Ausführung des Threads beginnt.	Running
Der Thread ruft Sleep auf.	WaitSleepJoin
Der Thread ruft Wait für ein anderes Objekt auf.	WaitSleepJoin
Der Thread ruft Join für einen anderen Thread auf.	WaitSleepJoin
Ein anderer Thread ruft Interrupt auf.	Running
Ein anderer Thread ruft Suspend auf.	SuspendRequested
Der Thread reagiert auf eine Suspend-Anforderung.	Suspended
Ein anderer Thread ruft Resume auf.	Running
Ein anderer Thread ruft Abort auf.	AbortRequested
Der Thread reagiert auf eine Abort-Anforderung.	Stopped
Ein Thread wird beendet.	Stopped

Zusätzlich zu den oben aufgeführten Zuständen gibt es den Background-Zustand, der angibt, ob der Thread im Hintergrund oder im Vordergrund ausgeführt wird.

Ein Thread kann sich gleichzeitig in mehreren Zuständen befinden. Wenn ein Thread z. B. bei einem Aufruf von Wait blockiert ist und ein anderer Thread Abort für den blockierten Thread aufruft, befindet sich der blockierte Thread gleichzeitig im WaitSleepJoin-Zustand und im AbortRequested-Zustand. In diesem Fall empfängt der Thread die ThreadAbortException zum Beginnen des Abbruchs, sobald er den Aufruf von Wait beendet hat oder unterbrochen wird.

Die Thread.ThreadState-Eigenschaft eines Threads stellt den aktuellen Zustand eines Threads bereit. Anwendungen müssen eine Bitmaske verwenden, um zu ermitteln, ob ein Thread ausgeführt wird. Da der Wert für Running 0 ist, überprüfen Sie, ob ein Thread ausgeführt wird, indem Sie C#-Code, z. B. (myThread.ThreadState & (ThreadState.Stopped | ThreadState.Unstarted)) == 0, oder Visual Basic-Code, z. B. (myThread.ThreadState And (ThreadState.Stopped Or ThreadState.Unstarted)) = 0, verwenden.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

System.Threading-Namespace
Thread-Klasse

Weitere Ressourcen

Zustände von verwalteten Threads
Verwaltetes und nicht verwaltetes Threading