Process.WaitForExit Método

Origem:

Process.cs

Origem:

Process.cs

Origem:

Process.cs

public:
 void WaitForExit();

public void WaitForExit ();

member this.WaitForExit : unit -> unit

Public Sub WaitForExit ()

Exceções

Exemplos

Consulte a seção Comentários da página de referência de StandardError propriedade.

Comentários

WaitForExit() faz com que o thread atual aguarde até que o processo associado seja encerrado. Ele deve ser chamado depois que todos os outros métodos forem chamados no processo. Para evitar o bloqueio do thread atual, use o evento Exited.

Esse método instrui o Process componente a aguardar uma quantidade infinita de tempo para que o processo e os manipuladores de eventos sejam encerrados. Isso pode fazer com que um aplicativo pare de responder. Por exemplo, se você chamar CloseMainWindow um processo que tenha uma interface do usuário, a solicitação ao sistema operacional para encerrar o processo associado poderá não ser tratada se o processo for gravado para nunca inserir seu loop de mensagem.

Essa sobrecarga garante que todo o processamento tenha sido concluído, incluindo o tratamento de eventos assíncronos para saída padrão redirecionada. Você deve usar essa sobrecarga após uma chamada para a sobrecarga quando a WaitForExit(Int32) saída padrão tiver sido redirecionada para manipuladores de eventos assíncronos.

Quando um processo associado é encerrado (ou seja, quando é desligado pelo sistema operacional por meio de uma terminação normal ou anormal), o sistema armazena informações administrativas sobre o processo e retorna ao componente que havia chamado WaitForExit(). Em Process seguida, o componente pode acessar as informações, que incluem o ExitTime, usando o Handle para o processo encerrado.

Como o processo associado foi encerrado, a Handle propriedade do componente não aponta mais para um recurso de processo existente. Em vez disso, o identificador só pode ser usado para acessar as informações do sistema operacional sobre o recurso de processo. O sistema está ciente dos identificadores para processos encerrados que não foram liberados pelos Process componentes, portanto, ele mantém as ExitTime informações e Handle na memória até que o Process componente libere especificamente os recursos. Por esse motivo, sempre que você chamar Start uma Process instância, chame Close quando o processo associado for encerrado e você não precisar mais de informações administrativas sobre ela. Close libera a memória alocada para o processo encerrado.

Confira também

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

Origem:

Process.cs

Origem:

Process.cs

Origem:

Process.cs

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

Retornos

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

Exceções

Exemplos

Consulte o exemplo de código para a ExitCode propriedade .

Comentários

WaitForExit(Int32) faz com que o thread atual aguarde até que o processo associado seja encerrado. Ele deve ser chamado depois que todos os outros métodos forem chamados no processo. Para evitar o bloqueio do thread atual, use o evento Exited.

Esse método instrui o Process componente a aguardar um período finito de tempo para que o processo seja encerrado. Se o processo associado não sair até o final do intervalo porque a solicitação de encerramento for negada, false será retornado ao procedimento de chamada. Você pode especificar Timeout.Infinite para millisecondse Process.WaitForExit(Int32) se comportará da mesma forma que a WaitForExit() sobrecarga. Se você passar 0 (zero) para o método , ele retornará true somente se o processo já tiver sido encerrado; caso contrário, retornará imediatamente false.

Quando a saída padrão tiver sido redirecionada para manipuladores de eventos assíncronos, é possível que o processamento de saída não tenha sido concluído quando esse método retornar. Para garantir que o tratamento de eventos assíncronos tenha sido concluído, chame a WaitForExit() sobrecarga que não usa nenhum parâmetro depois de receber um true dessa sobrecarga. Para ajudar a garantir que o Exited evento seja tratado corretamente em aplicativos Windows Forms, defina a SynchronizingObject propriedade .

Quando um processo associado é encerrado (é desligado pelo sistema operacional por meio de uma terminação normal ou anormal), o sistema armazena informações administrativas sobre o processo e retorna ao componente que havia chamado WaitForExit(Int32). Em Process seguida, o componente pode acessar as informações, que incluem o ExitTime, usando o Handle para o processo encerrado.

Como o processo associado foi encerrado, a Handle propriedade do componente não aponta mais para um recurso de processo existente. Em vez disso, o identificador só pode ser usado para acessar as informações do sistema operacional sobre o recurso de processo. O sistema está ciente dos identificadores para processos encerrados que não foram liberados pelos Process componentes, portanto, ele mantém as ExitTime informações e Handle na memória até que o Process componente libere especificamente os recursos. Por esse motivo, sempre que você chamar Start uma Process instância, chame Close quando o processo associado for encerrado e você não precisar mais de informações administrativas sobre ela. Close libera a memória alocada para o processo encerrado.

Confira também

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

Origem:

Process.cs

Origem:

Process.cs

Origem:

Process.cs

public:
 bool WaitForExit(TimeSpan timeout);

public bool WaitForExit (TimeSpan timeout);

member this.WaitForExit : TimeSpan -> bool

Public Function WaitForExit (timeout As TimeSpan) As Boolean

Parâmetros

Retornos

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

Comentários

Confira WaitForExit(Int32) os comentários.