Process.WaitForExit Метод

Исходный код:

Process.cs

Исходный код:

Process.cs

Исходный код:

Process.cs

public:
 void WaitForExit();

public void WaitForExit ();

member this.WaitForExit : unit -> unit

Public Sub WaitForExit ()

Исключения

Примеры

См. раздел Примечания на странице справочника по StandardError свойству.

Комментарии

WaitForExit() заставляет текущий поток ждать завершения связанного процесса. Он должен вызываться после вызова всех остальных методов в процессе. Чтобы избежать блокировки текущего потока, используйте событие Exited.

Этот метод указывает компоненту Process ждать бесконечное количество времени для завершения процесса и обработчиков событий. Это может привести к тому, что приложение перестанет отвечать на запросы. Например, при вызове CloseMainWindow процесса с пользовательским интерфейсом запрос к операционной системе на завершение связанного процесса может не обрабатываться, если процесс записан так, чтобы он никогда не входил в свой цикл сообщений.

Эта перегрузка гарантирует, что вся обработка завершена, включая обработку асинхронных событий для перенаправленных стандартных выходных данных. Эту перегрузку следует использовать после вызова перегрузки, WaitForExit(Int32) когда стандартные выходные данные перенаправляются в асинхронные обработчики событий.

При выходе связанного процесса (то есть при завершении работы операционной системой в результате нормального или аномального завершения) система сохраняет административные сведения о процессе и возвращается к компоненту, который вызвал WaitForExit(). Затем Process компонент может получить доступ к информации, которая включает в ExitTimeсебя , с помощью Handle для завершенного процесса.

Так как связанный процесс завершился, Handle свойство компонента больше не указывает на существующий ресурс процесса. Вместо этого дескриптор можно использовать только для доступа к сведениям операционной системы о ресурсе процесса. Система знает о дескрипторов для завершенных процессов, которые не были освобождены компонентами Process , поэтому она хранит ExitTime сведения и Handle в памяти до тех пор, пока Process компонент не освободит ресурсы. По этой причине каждый раз, когда вы вызываете StartProcess экземпляр, вызовите Close , когда связанный процесс завершился и вам больше не нужны какие-либо административные сведения о нем. Close освобождает память, выделенную для завершенного процесса.

См. также раздел

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

Исходный код:

Process.cs

Исходный код:

Process.cs

Исходный код:

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

Параметры

Возвращаемое значение

Значение true, если связанный процесс завершился; в противном случае — значение false.

Исключения

Примеры

См. пример кода для ExitCode свойства .

Комментарии

WaitForExit(Int32) заставляет текущий поток ждать завершения связанного процесса. Он должен вызываться после вызова всех остальных методов в процессе. Чтобы избежать блокировки текущего потока, используйте событие Exited.

Этот метод указывает компоненту Process ждать завершения процесса в течение ограниченного времени. Если связанный процесс не завершается к концу интервала, так как запрос на завершение отклоняется, false возвращается вызывающей процедуре. Можно указать Timeout.Infinite для milliseconds, и Process.WaitForExit(Int32) будет вести себя так же, как перегрузка WaitForExit() . Если передать 0 (ноль) в метод, он возвращается true только в том случае, если процесс уже завершился; в противном случае он немедленно возвращает .false

Если стандартные выходные данные были перенаправлены в асинхронные обработчики событий, возможно, обработка выходных данных не будет завершена при возврате этого метода. Чтобы убедиться, что асинхронная обработка событий завершена, вызовите перегрузку WaitForExit() , которая не принимает параметр после получения true от этой перегрузки . Чтобы обеспечить правильную обработку Exited события в Windows Forms приложениях, задайте SynchronizingObject свойство .

Когда связанный процесс завершается (завершается операционной системой через обычное или аномальное завершение), система сохраняет административные сведения о процессе и возвращается к компоненту, который вызвал WaitForExit(Int32). Затем Process компонент может получить доступ к информации, которая включает в ExitTimeсебя , с помощью Handle для завершенного процесса.

Так как связанный процесс завершился, Handle свойство компонента больше не указывает на существующий ресурс процесса. Вместо этого дескриптор можно использовать только для доступа к сведениям операционной системы о ресурсе процесса. Система знает о дескрипторов для завершенных процессов, которые не были освобождены компонентами Process , поэтому она хранит ExitTime сведения и Handle в памяти до тех пор, пока Process компонент не освободит ресурсы. По этой причине каждый раз, когда вы вызываете StartProcess экземпляр, вызовите Close , когда связанный процесс завершился и вам больше не нужны какие-либо административные сведения о нем. Close освобождает память, выделенную для завершенного процесса.

См. также раздел

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

Исходный код:

Process.cs

Исходный код:

Process.cs

Исходный код:

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

Параметры

Возвращаемое значение

Значение true, если связанный процесс завершился; в противном случае — значение false.

Комментарии

См. WaitForExit(Int32) примечания.