ThreadState 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定 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
- 继承
- 属性
字段
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
定义线程的所有可能执行状态集。 它只对几个调试方案感兴趣。 代码不应使用线程状态来同步线程的活动。
创建线程后,它至少处于其中一个状态,直到它终止。 在公共语言运行时中创建的线程最初处于 Unstarted 状态,而进入运行时的外部线程或非托管线程已处于 Running 状态。 线程通过调用Thread.Start从Unstarted状态Running转换为状态。 线程由于调用 Unstarted 而离开 Start状态后,它将无法再返回到 Unstarted 状态。
线程在给定时间可以处于多个状态。 例如,如果在调用 Monitor.Wait时阻止线程,而阻止线程上的另一个线程调用 Thread.Abort ,则阻塞的线程将同时处于 WaitSleepJoin 和 AbortRequested 状态。 在这种情况下,只要线程从调用 Monitor.Wait 返回或中断,它就会收到开始中止的命令 ThreadAbortException 。 并非所有值组合 ThreadState
都有效;例如,线程不能同时 Aborted 处于和 Unstarted 状态。
同样,线程也永远无法离开 Stopped 状态。
重要
有两个线程状态枚举: System.Threading.ThreadState 和 System.Diagnostics.ThreadState。
下表显示了导致状态更改的操作。
操作 | ThreadState |
---|---|
线程是在公共语言运行时中创建的。 | 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