Process.WaitForInputIdle Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Faz com que o componente Process aguarde até o processo associado entrar em um estado ocioso.

Sobrecargas

WaitForInputIdle()	Faz com que o componente Process aguarde por tempo indefinido até que o processo associado entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.
WaitForInputIdle(Int32)	Faz com que o componente Process a aguarde o número especificado de milissegundos para que o processo entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.
WaitForInputIdle(TimeSpan)	Faz com que o Process componente aguarde o especificado timeout para que o processo associado entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.

WaitForInputIdle()

Origem:

Process.cs

Faz com que o componente Process aguarde por tempo indefinido até que o processo associado entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.

public:
 bool WaitForInputIdle();

public bool WaitForInputIdle ();

member this.WaitForInputIdle : unit -> bool

Public Function WaitForInputIdle () As Boolean

Retornos

Boolean

true se o processo associado tiver atingido um estado ocioso.

Exceções

InvalidOperationException

O processo não tem uma interface gráfica.

- ou -

Erro desconhecido. O processo não conseguiu entrar em um estado ocioso.

- ou -

O processo já terminou.

- ou -

Nenhum processo está associado a esse objeto Process.

Comentários

Use WaitForInputIdle() para forçar o processamento do aplicativo a aguardar até que o loop de mensagem retorne ao estado ocioso. Quando um processo com uma interface do usuário está em execução, seu loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional. Em seguida, o processo retorna ao loop de mensagem. Diz-se que um processo está em um estado ocioso quando está aguardando mensagens dentro de um loop de mensagem. Esse estado é útil, por exemplo, quando seu aplicativo precisa aguardar até que um processo inicial termine de criar sua janela main antes que o aplicativo se comunique com essa janela.

Se um processo não tiver um loop de mensagem, WaitForInputIdle() gerará um InvalidOperationException.

A WaitForInputIdle() sobrecarga instrui o Process componente a aguardar indefinidamente para que o processo fique ocioso no loop de mensagem. Essa instrução pode fazer com que um aplicativo pare de responder. Por exemplo, se o processo for gravado para sempre sair de seu loop de mensagem imediatamente, como no fragmento while(true)de código .

Confira também

• Start()
• CloseMainWindow()

WaitForInputIdle(Int32)

Origem:

Process.cs

Faz com que o componente Process a aguarde o número especificado de milissegundos para que o processo entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.

public:
 bool WaitForInputIdle(int milliseconds);

public bool WaitForInputIdle (int milliseconds);

member this.WaitForInputIdle : int -> bool

Public Function WaitForInputIdle (milliseconds As Integer) As Boolean

Parâmetros

milliseconds

Int32

Um valor de 1 a Int32.MaxValue que especifica a quantidade de tempo, em milissegundos, para aguardar o processo associado ficar ocioso. Um valor de 0 especifica um retorno imediato e um valor de -1 especifica uma espera infinita.

Retornos

Boolean

true se o processo associado tiver atingido um estado ocioso; caso contrário, false.

Exceções

InvalidOperationException

O processo não tem uma interface gráfica.

- ou -

Erro desconhecido. O processo não conseguiu entrar em um estado ocioso.

- ou -

O processo já terminou.

- ou -

Nenhum processo está associado a esse objeto Process.

Comentários

Use WaitForInputIdle(Int32) para forçar o processamento do aplicativo a aguardar até que o loop de mensagem retorne ao estado ocioso. Quando um processo com uma interface do usuário está em execução, seu loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional. Em seguida, o processo retorna ao loop de mensagem. Diz-se que um processo está em um estado ocioso quando está aguardando mensagens dentro de um loop de mensagem. Esse estado é útil, por exemplo, quando seu aplicativo precisa aguardar até que um processo inicial termine de criar sua janela main antes que o aplicativo se comunique com essa janela.

Se um processo não tiver um loop de mensagem, WaitForInputIdle(Int32) gerará um InvalidOperationException.

A WaitForInputIdle(Int32) sobrecarga instrui o Process componente a aguardar uma quantidade finita de tempo para que o processo fique ocioso no loop de mensagem. Se o processo associado não ficar ocioso até o final do intervalo porque o loop ainda está processando mensagens, false será retornado ao procedimento de chamada.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Confira também

• Start()
• CloseMainWindow()

WaitForInputIdle(TimeSpan)

Origem:

Process.cs

Faz com que o Process componente aguarde o especificado timeout para que o processo associado entre em um estado ocioso. Essa sobrecarga se aplica apenas a processos com uma interface do usuário e, portanto, um loop de mensagem.

public:
 bool WaitForInputIdle(TimeSpan timeout);

public bool WaitForInputIdle (TimeSpan timeout);

member this.WaitForInputIdle : TimeSpan -> bool

Public Function WaitForInputIdle (timeout As TimeSpan) As Boolean

Parâmetros

timeout

TimeSpan

O período de tempo, em milissegundos, para esperar que o processo associado fique ocioso.

Retornos

Boolean

true se o processo associado tiver atingido um estado ocioso; caso contrário, false.

Exceções

InvalidOperationException

O processo não tem uma interface gráfica.

- ou -

Erro desconhecido. O processo não conseguiu entrar em um estado ocioso.

- ou -

O processo já terminou.

- ou -

Nenhum processo está associado a esse objeto Process.

Comentários

Use WaitForInputIdle(TimeSpan) para forçar o processamento do aplicativo a aguardar até que o loop de mensagem retorne ao estado ocioso.

Quando um processo com uma interface do usuário está em execução, seu loop de mensagem é executado sempre que uma mensagem do Windows é enviada ao processo pelo sistema operacional.

Em seguida, o processo retorna ao loop de mensagem. Diz-se que um processo está em um estado ocioso quando está aguardando mensagens dentro de um loop de mensagem.

Esse estado é útil, por exemplo, quando seu aplicativo precisa aguardar até que um processo inicial termine de criar sua janela main antes que o aplicativo se comunique com essa janela.