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
- 继承
- 属性
字段
| 名称 | 值 | 说明 |
|---|---|---|
| Running | 0 | 线程已启动,但尚未停止。 |
| StopRequested | 1 | 正在请求线程停止。 这是仅供内部使用。 |
| SuspendRequested | 2 | 正在请求线程挂起。 |
| Background | 4 | 该线程作为后台线程执行,而不是前台线程。 通过设置属性来控制此 IsBackground 状态。 |
| Unstarted | 8 | 该方法 Start() 尚未在线程上调用。 |
| Stopped | 16 | 线程已停止。 |
| WaitSleepJoin | 32 | 线程被阻止。 这可能是调用Sleep(Int32)Join()或请求锁的结果,例如,通过调用Enter(Object)或 Wait(Object, Int32, Boolean) -或等待线程同步对象(例如ManualResetEvent)。 |
| Suspended | 64 | 线程已挂起。 |
| AbortRequested | 128 | 该方法 Abort(Object) 已在线程上调用,但该线程尚未收到将尝试终止该方法的挂起 ThreadAbortException 。 |
| Aborted | 256 | 线程状态包括 AbortRequested 并且线程现在已死亡,但其状态尚未更改为 Stopped。 |
注解
枚举 ThreadState 定义线程的所有可能执行状态集。 它只对几个调试方案感兴趣。 代码不应使用线程状态来同步线程的活动。
创建线程后,它至少处于其中一个状态,直到它终止。 在公共语言运行时中创建的线程最初处于 Unstarted 状态,而进入运行时的外部线程或非托管线程已处于 Running 该状态。 线程通过调用Thread.Start从状态转换为UnstartedRunning状态。 线程离开 Unstarted 状态作为调用 Start的结果后,它永远无法返回到 Unstarted 状态。
线程在给定时间可以处于多个状态。 例如,如果在调用 Monitor.Wait时阻止线程,而阻止线程上的另一个线程调用 Thread.Abort ,则阻塞线程将同时处于 WaitSleepJoin 和 AbortRequested 状态。 在这种情况下,只要线程从调用 Monitor.Wait 返回或中断,它就会收到开始中止的 ThreadAbortException 命令。 并非所有值组合 ThreadState 都有效;例如,线程不能同时 Aborted 处于和 Unstarted 状态。
线程永远不能离开状态 Stopped 。
重要
有两个线程状态枚举: System.Threading.ThreadState 和 System.Diagnostics.ThreadState。
下表显示了导致状态更改的操作。
| Action | 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