Process.WaitForExit Método

public:
 void WaitForExit();

public void WaitForExit();

member this.WaitForExit : unit -> unit

Public Sub WaitForExit ()

Exceções

Exemplos

Consulte a secção de Observações da StandardError página de referência da propriedade.

Observações

WaitForExit() faz com que a thread atual espere até que o processo associado termine. Deve ser chamado depois de todos os outros métodos serem chamados no processo. Para evitar bloquear o tópico atual, use o Exited evento.

Este método instrui o Process componente a esperar um tempo infinito para que o processo e os gestores de eventos saiam. Isto pode fazer com que uma candidatura deixe de responder. Por exemplo, se chamar CloseMainWindow um processo que tenha uma interface de utilizador, o pedido ao sistema operativo para terminar o processo associado pode não ser tratado se o processo for escrito para nunca entrar no seu ciclo de mensagens.

Esta sobrecarga garante que todo o processamento foi concluído, incluindo o tratamento de eventos assíncronos para saída padrão redirecionada. Deve usar esta sobrecarga após uma chamada para a WaitForExit(Int32) sobrecarga quando a saída padrão foi redirecionada para manipuladores de eventos assíncronos.

Quando um processo associado sai (isto é, quando é desligado pelo sistema operativo através de uma terminação normal ou anormal), o sistema armazena informação administrativa sobre o processo e devolve ao componente que chamou WaitForExit(). O Process componente pode então aceder à informação, que inclui o ExitTime, usando o Handle para o processo finalizado.

Como o processo associado saiu, a Handle propriedade do componente já não aponta para um recurso de processo existente. Em vez disso, o handle pode ser usado apenas para aceder à informação do sistema operativo sobre o recurso do processo. O sistema está ciente dos handles dos processos encerrados que não foram libertados pelos Process componentes, por isso mantém a ExitTime informação e Handle na memória até que o Process componente liberte especificamente os recursos. Por esta razão, sempre que ligar Start para uma Process instância, ligue Close quando o processo associado terminar e já não precisar de qualquer informação administrativa sobre ele. Close liberta a memória alocada ao processo encerrado.

Ver também

• CloseMainWindow()
• Kill()
• Handle
• ExitTime
• EnableRaisingEvents
• HasExited
• Exited

public:
 bool WaitForExit(int milliseconds);

public bool WaitForExit(int milliseconds);

member this.WaitForExit : int -> bool

Public Function WaitForExit (milliseconds As Integer) As Boolean

Parâmetros

Devoluções

true se o processo associado tiver terminado; caso contrário, false.

Exceções

Exemplos

Veja o exemplo do código da ExitCode propriedade.

Observações

WaitForExit(Int32) faz com que a thread atual espere até que o processo associado termine. Deve ser chamado depois de todos os outros métodos serem chamados no processo. Para evitar bloquear o tópico atual, use o Exited evento.

Este método instrui o Process componente a esperar um tempo finito até que o processo termine. Se o processo associado não sair até ao final do intervalo porque o pedido de terminação foi negado, false é devolvido ao procedimento de chamada. Podes especificar Timeout.Infinite para milliseconds, e Process.WaitForExit(Int32) irá comportar-se da mesma forma que a WaitForExit() sobrecarga. Se passar 0 (zero) ao método, ele retorna true apenas se o processo já tiver terminado; caso contrário, retorna falseimediatamente .

Quando a saída padrão foi redirecionada para manipuladores de eventos assíncronos, é possível que o processamento de saída não tenha sido concluído quando este método regressar. Para garantir que o tratamento assíncrono de eventos foi concluído, chame a WaitForExit() sobrecarga que não toma nenhum parâmetro após receber a true dessa sobrecarga. Para ajudar a garantir que o evento Exited é tratado corretamente nas Windows Forms aplicações, defina a propriedade SynchronizingObject.

Quando um processo associado sai (é desligado pelo sistema operativo através de uma terminação normal ou anormal), o sistema armazena informação administrativa sobre o processo e devolve ao componente que chamou WaitForExit(Int32). O Process componente pode então aceder à informação, que inclui o ExitTime, usando o Handle para o processo finalizado.

Como o processo associado saiu, a Handle propriedade do componente já não aponta para um recurso de processo existente. Em vez disso, o handle pode ser usado apenas para aceder à informação do sistema operativo sobre o recurso do processo. O sistema está ciente dos handles dos processos encerrados que não foram libertados pelos Process componentes, por isso mantém a ExitTime informação e Handle na memória até que o Process componente liberte especificamente os recursos. Por esta razão, sempre que ligar Start para uma Process instância, ligue Close quando o processo associado terminar e já não precisar de qualquer informação administrativa sobre ele. Close liberta a memória alocada ao processo encerrado.

Ver também

• CloseMainWindow()
• Kill()
• Handle
• ExitTime
• EnableRaisingEvents
• HasExited
• Exited
• SynchronizingObject