Process.Exited Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando um processo termina.
public:
event EventHandler ^ Exited;
public event EventHandler Exited;
member this.Exited : EventHandler
Public Custom Event Exited As EventHandler
Tipo de Evento
Exemplos
O seguinte exemplo de código cria um processo que imprime um ficheiro. Levanta o Exited evento quando o processo sai porque a EnableRaisingEvents propriedade foi definida quando o processo foi criado. O Exited gestor de eventos apresenta informações de processos.
using System;
using System.Diagnostics;
using System.Threading.Tasks;
class PrintProcessClass
{
private Process myProcess;
private TaskCompletionSource<bool> eventHandled;
// Print a file with any known extension.
public async Task PrintDoc(string fileName)
{
eventHandled = new TaskCompletionSource<bool>();
using (myProcess = new Process())
{
try
{
// Start a process to print a file and raise an event when done.
myProcess.StartInfo.FileName = fileName;
myProcess.StartInfo.Verb = "Print";
myProcess.StartInfo.CreateNoWindow = true;
myProcess.EnableRaisingEvents = true;
myProcess.Exited += new EventHandler(myProcess_Exited);
myProcess.Start();
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred trying to print \"{fileName}\":\n{ex.Message}");
return;
}
// Wait for Exited event, but not more than 30 seconds.
await Task.WhenAny(eventHandled.Task,Task.Delay(30000));
}
}
// Handle Exited event and display process information.
private void myProcess_Exited(object sender, System.EventArgs e)
{
Console.WriteLine(
$"Exit time : {myProcess.ExitTime}\n" +
$"Exit code : {myProcess.ExitCode}\n" +
$"Elapsed time : {Math.Round((myProcess.ExitTime - myProcess.StartTime).TotalMilliseconds)}");
eventHandled.TrySetResult(true);
}
public static async Task Main(string[] args)
{
// Verify that an argument has been entered.
if (args.Length <= 0)
{
Console.WriteLine("Enter a file name.");
return;
}
// Create the process and print the document.
PrintProcessClass myPrintProcess = new PrintProcessClass();
await myPrintProcess.PrintDoc(args[0]);
}
}
open System
open System.Diagnostics
open System.Threading.Tasks
let mutable myProcess = new Process()
let mutable eventHandled = TaskCompletionSource<bool>()
// Handle Exited event and display process information.
let myProcess_Exited (sender: obj) (e: EventArgs) =
printfn $"Exit time : {myProcess.ExitTime}\n"
printfn $"Exit code : {myProcess.ExitCode}\n"
printfn $"Elapsed time : {round ((myProcess.ExitTime - myProcess.StartTime).TotalMilliseconds)}"
eventHandled.TrySetResult true |> ignore
// Print a file with any known extension.
let printDoc fileName =
task {
eventHandled <- TaskCompletionSource<bool>()
use myProcess = new Process()
try
// Start a process to print a file and raise an event when done.
myProcess.StartInfo.FileName <- fileName
myProcess.StartInfo.Verb <- "Print"
myProcess.StartInfo.CreateNoWindow <- true
myProcess.EnableRaisingEvents <- true
myProcess.Exited.AddHandler(EventHandler myProcess_Exited)
myProcess.Start() |> ignore
with ex ->
printfn $"An error occurred trying to print \"{fileName}\":\n{ex.Message}"
// Wait for Exited event, but not more than 30 seconds.
let! _ = Task.WhenAny(eventHandled.Task, Task.Delay(30000))
()
}
[<EntryPoint>]
let main args =
// Verify that an argument has been entered.
if args.Length <= 0 then
printfn "Enter a file name."
else
// Create the process and print the document.
printDoc(args[0]).Wait() |> ignore
0
Imports System.Diagnostics
Class PrintProcessClass
Private WithEvents myProcess As Process
Private eventHandled As TaskCompletionSource(Of Boolean)
' Print a file with any known extension.
Async Function PrintDoc(ByVal fileName As String) As Task
eventHandled = New TaskCompletionSource(Of Boolean)()
myProcess = New Process
Using myProcess
Try
' Start a process to print a file and raise an event when done.
myProcess.StartInfo.FileName = fileName
myProcess.StartInfo.Verb = "Print"
myProcess.StartInfo.CreateNoWindow = True
myProcess.EnableRaisingEvents = True
AddHandler myProcess.Exited, New EventHandler(AddressOf myProcess_Exited)
myProcess.Start()
Catch ex As Exception
Console.WriteLine("An error occurred trying to print ""{0}"":" &
vbCrLf & ex.Message, fileName)
Return
End Try
' Wait for Exited event, but not more than 30 seconds.
Await Task.WhenAny(eventHandled.Task, Task.Delay(30000))
End Using
End Function
' Handle Exited event and display process information.
Private Sub myProcess_Exited(ByVal sender As Object,
ByVal e As System.EventArgs)
Console.WriteLine("Exit time: {0}" & vbCrLf &
"Exit code: {1}" & vbCrLf & "Elapsed time: {2}",
myProcess.ExitTime, myProcess.ExitCode,
Math.Round((myProcess.ExitTime - myProcess.StartTime).TotalMilliseconds))
eventHandled.TrySetResult(True)
End Sub
Shared Sub Main(ByVal args As String())
' Verify that an argument has been entered.
If args.Length <= 0 Then
Console.WriteLine("Enter a file name.")
Return
End If
' Create the process and print the document.
Dim myPrintProcess As New PrintProcessClass
myPrintProcess.PrintDoc(args(0)).Wait()
End Sub
End Class
Observações
O Exited evento indica que o processo associado foi encerrado. Esta ocorrência significa que o processo terminou (abortou) ou foi encerrado com sucesso. Este evento só pode ocorrer se o valor da EnableRaisingEvents propriedade for true.
Existem duas formas de ser notificado quando o processo associado termina: síncrona e assíncrona. Notificação síncrona significa chamar o WaitForExit método para bloquear o thread atual até o processo sair. A notificação assíncrona utiliza o Exited evento, o que permite que o fio que chama continue a execução entretanto. Neste último caso, EnableRaisingEvents deve ser definido como true para que a aplicação que chama receba o evento Exited.
Quando o sistema operativo desliga um processo, notifica todos os outros processos que tenham manipuladores registados para o evento Exited. Neste momento, o handle do processo que acabou de sair pode ser usado para aceder a algumas propriedades como ExitTime e HasExited que o sistema operativo mantém até libertar esse handle completamente.
Note
Mesmo que já tenha controlo de um processo encerrado, não pode voltar a ligar Start para voltar a ligar-se ao mesmo processo. Chamar Start liberta automaticamente o processo associado e liga-se a um processo com o mesmo ficheiro, mas com um ficheiro totalmente novo Handle.
Para mais informações sobre a utilização do evento Exited em aplicações Windows Forms, consulte a propriedade SynchronizingObject.