ThreadState Перечисление

Определение

Пространство имен:

System.Threading

Сборка:

System.Threading.Thread.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Задает состояния выполнения объекта Thread.

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class ThreadState

[System.Flags]
public enum ThreadState

[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ThreadState

[System.Flags]
[System.Serializable]
public enum ThreadState

[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public enum ThreadState

[<System.Flags>]
type ThreadState = 

[<System.Flags>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ThreadState = 

[<System.Flags>]
[<System.Serializable>]
type ThreadState = 

[<System.Flags>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ThreadState = 

Public Enum ThreadState

Наследование

Object

ValueType

Enum

ThreadState

Атрибуты

FlagsAttribute ComVisibleAttribute SerializableAttribute

Поля

Aborted	256	Состояние потока включает в себя значение AbortRequested, и поток теперь не выполняет работу, но его состояние еще не изменилось на Stopped.
AbortRequested	128	Метод Abort(Object) был вызван для потока, но поток еще не получил исключение ThreadAbortException, которое попытается завершить его.
Background	4	Поток выполняется как фоновый поток, в противоположность потокам переднего плана. Это состояние управляется заданием свойства IsBackground.
Running	0	Поток был запущен, но не останавливался.
Stopped	16	Поток был остановлен.
StopRequested	1	Поток получает запрос на остановку. Предназначено только для внутреннего использования.
Suspended	64	Поток был приостановлен.
SuspendRequested	2	Запрашивается приостановка работы потока.
Unstarted	8	Метод Start() не был вызван для потока.
WaitSleepJoin	32	Поток заблокирован. Это может произойти в результате вызова метода Sleep(Int32) или метода Join(), в результате запроса блокировки, например при вызове метода Enter(Object) или Wait(Object, Int32, Boolean) или в результате ожидания объекта синхронизации потока, такого как ManualResetEvent.

Комментарии

Перечисление ThreadState определяет набор всех возможных состояний выполнения для потоков. Он представляет интерес только в нескольких сценариях отладки. Код никогда не должен использовать состояние потока для синхронизации действий потоков.

После создания потока он находится по крайней мере в одном из состояний, пока не завершит работу. Потоки, созданные в среде CLR, изначально находятся в Unstarted состоянии , а внешние или неуправляемые потоки, поступающие в среду выполнения, уже находятся в Running состоянии . Поток переходит из состояния в Unstarted состояние путем Running вызова Thread.Start. Если поток был выведен из состояния Unstarted в результате вызова метода Start, он не может вернуться в состояние Unstarted ни при каких условиях.

Поток может находиться в нескольких состояниях в данный момент времени. Например, если поток блокируется при вызове Monitor.Wait, а другой поток вызывает Thread.Abort заблокированный поток, заблокированный поток будет одновременно находиться в WaitSleepJoin состояниях и AbortRequested . В этом случае, как только поток возвращается из вызова Monitor.Wait или прерывается, он получит ThreadAbortException , чтобы начать прерывание. Не все сочетания значений ThreadState являются допустимыми; например, поток не может находиться в обоих состояниях Aborted и Unstarted .

Поток никогда не может выйти из состояния Stopped .

Важно!

Существует два перечисления состояния потока: System.Threading.ThreadState и System.Diagnostics.ThreadState.

В следующей таблице показаны действия, вызывающие изменение состояния.

Действие	ThreadState
Поток создается в среде CLR.	Unstarted
Другой поток вызывает Thread.Start метод в новом потоке, и вызов возвращает . Метод Start не возвращается, пока не начнется выполнение нового потока. Невозможно узнать, в какой момент новый поток начнет выполняться во время вызова Start.	Running
Вызовы потока Sleep	WaitSleepJoin
Поток вызывает Monitor.Wait другого объекта.	WaitSleepJoin
Поток вызывает Join другого потока.	WaitSleepJoin
Вызовы другого потока Interrupt	Running
Вызовы другого потока Suspend	SuspendRequested
Поток отвечает на запрос Suspend.	Suspended
Вызовы другого потока Resume	Running
Вызовы другого потока Abort	AbortRequested
Поток отвечает на Abort запрос.	Stopped
Поток завершается.	Stopped

Помимо указанных выше состояний, существует также Background состояние , которое указывает, выполняется ли поток на фоновом или переднем плане. См. дополнительные сведения об основных и фоновых потоках.

Свойство Thread.ThreadState потока предоставляет текущее состояние потока. Приложения должны использовать битовую маску, чтобы определить, выполняется ли поток. Так как значение для Running равно нулю (0), проверьте, выполняется ли поток, с помощью следующего кода:

(myThread.ThreadState & (ThreadState.Stopped | ThreadState.Unstarted)) == 0

(myThread.ThreadState And (ThreadState.Stopped Or ThreadState.Unstarted)) = 0

См. также раздел

• Thread