Process.WaitForInputIdle 方法

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.Process.dll

使 Process 组件等待关联进程进入空闲状态。

重载

WaitForInputIdle()	使 Process 组件无限期地等待关联进程进入空闲状态。 此重载仅适用于具有用户界面并因此具有消息循环的进程。
WaitForInputIdle(Int32)	使 Process 组件在指定的毫秒数内等待关联进程进入空闲状态。 此重载仅适用于具有用户界面并因此具有消息循环的进程。
WaitForInputIdle(TimeSpan)	Process使组件等待指定的 timeout ，使关联的进程进入空闲状态。 此重载仅适用于具有用户界面并因此具有消息循环的进程。

WaitForInputIdle()

Source:

Process.cs

使 Process 组件无限期地等待关联进程进入空闲状态。 此重载仅适用于具有用户界面并因此具有消息循环的进程。

public:
 bool WaitForInputIdle();

public bool WaitForInputIdle ();

member this.WaitForInputIdle : unit -> bool

Public Function WaitForInputIdle () As Boolean

返回

Boolean

如果关联进程已经达到空闲状态，则为 true。

例外

InvalidOperationException

进程不具有图形界面。

或

发生未知错误。 进程无法进入空闲状态。

或

已经退出该进程。

或

没有与此 Process 对象关联的进程。

注解

使用 WaitForInputIdle() 强制处理应用程序，直到消息循环返回到空闲状态。 当具有用户界面的进程正在执行时，操作系统每次将 Windows 消息发送到进程时，其消息循环都会执行。 然后，进程将返回到消息循环。 进程在等待消息循环中的消息时，据说它处于空闲状态。 例如，当应用程序需要等待启动进程完成创建其main窗口之前，应用程序与该窗口通信时，此状态非常有用。

如果进程没有消息循环， WaitForInputIdle() 则 InvalidOperationException引发 。

重 WaitForInputIdle() 载指示 Process 组件无限期等待进程在消息循环中变为空闲状态。 此指令可能导致应用程序停止响应。 例如，如果将进程编写为始终立即退出其消息循环，如代码片段 while(true)中所示。

另请参阅

• Start()
• CloseMainWindow()

WaitForInputIdle(Int32)

Source:

Process.cs

使 Process 组件在指定的毫秒数内等待关联进程进入空闲状态。 此重载仅适用于具有用户界面并因此具有消息循环的进程。

public:
 bool WaitForInputIdle(int milliseconds);

public bool WaitForInputIdle (int milliseconds);

member this.WaitForInputIdle : int -> bool

Public Function WaitForInputIdle (milliseconds As Integer) As Boolean

参数

milliseconds

Int32

值 1 到 Int32.MaxValue ，指定等待关联进程空闲的时间量（以毫秒为单位）。 0 值指定立即返回，而 -1 值则指定无限期等待。

返回

Boolean

如果关联进程已经达到空闲状态，则为 true；否则为 false。

例外

InvalidOperationException

进程不具有图形界面。

或

发生未知错误。 进程无法进入空闲状态。

或

已经退出该进程。

或

没有与此 Process 对象关联的进程。

注解

使用 WaitForInputIdle(Int32) 强制处理应用程序，直到消息循环返回到空闲状态。 当具有用户界面的进程正在执行时，操作系统每次将 Windows 消息发送到进程时，其消息循环都会执行。 然后，进程将返回到消息循环。 进程在等待消息循环中的消息时，据说它处于空闲状态。 例如，当应用程序需要等待启动进程完成创建其main窗口之前，应用程序与该窗口通信时，此状态非常有用。

如果进程没有消息循环， WaitForInputIdle(Int32) 则 InvalidOperationException引发 。

重 WaitForInputIdle(Int32) 载指示 Process 组件等待有限时间，使进程在消息循环中处于空闲状态。 如果关联进程由于循环仍在处理消息而未在间隔结束时变为空闲状态， false 则会返回到调用过程。

有关处理事件的详细信息，请参阅 处理和引发事件。

另请参阅

• Start()
• CloseMainWindow()

WaitForInputIdle(TimeSpan)

Source:

Process.cs

Process使组件等待指定的 timeout ，使关联的进程进入空闲状态。 此重载仅适用于具有用户界面并因此具有消息循环的进程。

public:
 bool WaitForInputIdle(TimeSpan timeout);

public bool WaitForInputIdle (TimeSpan timeout);

member this.WaitForInputIdle : TimeSpan -> bool

Public Function WaitForInputIdle (timeout As TimeSpan) As Boolean

参数

timeout

TimeSpan

等待关联进程变为空闲状态的时间（以毫秒为单位）。

返回

Boolean

如果关联进程已经达到空闲状态，则为 true；否则为 false。

例外

InvalidOperationException

进程不具有图形界面。

或

发生未知错误。 进程无法进入空闲状态。

或

已经退出该进程。

或

没有与此 Process 对象关联的进程。

注解

使用 WaitForInputIdle(TimeSpan) 强制处理应用程序，直到消息循环返回到空闲状态。

当具有用户界面的进程正在执行时，操作系统每次将 Windows 消息发送到进程时，其消息循环都会执行。

然后，进程将返回到消息循环。 进程在等待消息循环中的消息时，据说它处于空闲状态。

例如，当应用程序需要等待启动进程完成创建其main窗口之前，应用程序与该窗口通信时，此状态非常有用。