Process.WaitForInputIdle メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.Process.dll

関連付けられたプロセスがアイドル状態になるまで、Process コンポーネントを待機させます。

オーバーロード

WaitForInputIdle()	関連付けられたプロセスがアイドル状態になるまで、Process コンポーネントを無期限に待機させます。 このオーバーロードは、ユーザー インターフェイスとメッセージ ループを持つプロセスにだけ適用されます。
WaitForInputIdle(Int32)	関連付けられたプロセスがアイドル状態になるまで、最大で指定したミリ秒間、Process コンポーネントを待機させます。 このオーバーロードは、ユーザー インターフェイスとメッセージ ループを持つプロセスにだけ適用されます。
WaitForInputIdle(TimeSpan)	関連付けられたプロセスが Process アイドル状態になるまで、指定された timeout をコンポーネントが待機させます。 このオーバーロードは、ユーザー インターフェイスとメッセージ ループを持つプロセスにだけ適用されます。

WaitForInputIdle()

ソース:

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 メッセージがプロセスに送信されるたびに、そのメッセージ ループが実行されます。 その後、プロセスはメッセージ ループに戻ります。 プロセスは、メッセージ ループ内のメッセージを待機しているときにアイドル状態であると言われます。 この状態は、たとえば、アプリケーションがそのウィンドウと通信する前に、開始プロセスがメイン ウィンドウの作成を完了するまで待機する必要がある場合に便利です。

プロセスにメッセージ ループがない場合は、 WaitForInputIdle() を InvalidOperationExceptionスローします。

オーバーロードは WaitForInputIdle() 、プロセスが Process メッセージ ループでアイドル状態になるまで無期限に待機するようにコンポーネントに指示します。 この命令により、アプリケーションが応答を停止する可能性があります。 たとえば、コード フラグメント while(true)のように、常にメッセージ ループを直ちに終了するようにプロセスが書き込まれる場合です。

こちらもご覧ください

• Start()
• CloseMainWindow()

WaitForInputIdle(Int32)

ソース:

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

関連付けられたプロセスがアイドル状態になるまで待機する時間をミリ秒単位で指定する Int32.MaxValue の値は 1 です。 値 0 の場合はすぐに制御が戻され、値 -1 の場合は無期限に待機することを示します。

戻り値

Boolean

関連付けられたプロセスがアイドル状態になった場合は true。それ以外の場合は false。

例外

InvalidOperationException

プロセスにグラフィカル インターフェイスがありません。

または

不明なエラーが発生しました。 プロセスがアイドル状態になることができませんでした。

または

プロセスは既に終了しています。

または

この Process オブジェクトに関連付けられているプロセスはありません。

注釈

メッセージ ループがアイドル状態に戻るまでアプリケーションの処理を強制的に待機するには、 を使用 WaitForInputIdle(Int32) します。 ユーザー インターフェイスを持つプロセスが実行されている場合、オペレーティング システムによって Windows メッセージがプロセスに送信されるたびに、そのメッセージ ループが実行されます。 その後、プロセスはメッセージ ループに戻ります。 プロセスは、メッセージ ループ内のメッセージを待機しているときにアイドル状態であると言われます。 この状態は、たとえば、アプリケーションがそのウィンドウと通信する前に、開始プロセスがメイン ウィンドウの作成を完了するまで待機する必要がある場合に便利です。

プロセスにメッセージ ループがない場合は、 WaitForInputIdle(Int32) を InvalidOperationExceptionスローします。

オーバーロードは WaitForInputIdle(Int32) 、プロセスが Process メッセージ ループでアイドル状態になるまで、有限の時間待機するようにコンポーネントに指示します。 ループがまだメッセージを処理しているために、関連付けられたプロセスが間隔の終わりまでにアイドル状態にならない場合は、 false が呼び出し元のプロシージャに返されます。

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。

こちらもご覧ください

• Start()
• CloseMainWindow()

WaitForInputIdle(TimeSpan)

ソース:

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 メッセージがプロセスに送信されるたびに、そのメッセージ ループが実行されます。

その後、プロセスはメッセージ ループに戻ります。 プロセスは、メッセージ ループ内のメッセージを待機しているときにアイドル状態であると言われます。

この状態は、たとえば、アプリケーションがそのウィンドウと通信する前に、開始プロセスがメイン ウィンドウの作成を完了するまで待機する必要がある場合に便利です。