Process.Exited Ereignis

Definition

Namespace:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.Process.dll

Quelle:

Process.cs

Tritt auf, wenn ein Prozess beendet wird.

public:
 event EventHandler ^ Exited;

public event EventHandler Exited;

member this.Exited : EventHandler 

Public Custom Event Exited As EventHandler 

Ereignistyp

EventHandler

Beispiele

Im folgenden Codebeispiel wird ein Prozess erstellt, der eine Datei druckt. Das Ereignis wird ausgelöst Exited , wenn der Prozess beendet wird, da die EnableRaisingEvents Eigenschaft beim Erstellen des Prozesses festgelegt wurde. Der Exited Ereignishandler zeigt Prozessinformationen an.

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

Hinweise

Das Exited Ereignis gibt an, dass der zugeordnete Prozess beendet wurde. Dieses Vorkommen bedeutet, dass der Prozess entweder beendet (abgebrochen) oder erfolgreich geschlossen wurde. Dieses Ereignis kann nur auftreten, wenn der Wert der EnableRaisingEvents Eigenschaft lautet true.

Es gibt zwei Möglichkeiten, benachrichtigt zu werden, wenn der zugeordnete Prozess beendet wird: synchron und asynchron. Synchrone Benachrichtigung bedeutet, dass die WaitForExit Methode aufgerufen wird, um den aktuellen Thread zu blockieren, bis der Prozess beendet wird. Asynchrone Benachrichtigung verwendet das Exited Ereignis, mit dem der aufrufende Thread die Ausführung in der Zwischenzeit fortsetzen kann. Im letzteren Fall muss festgelegt true werden, EnableRaisingEvents damit die aufrufende Anwendung das Exited-Ereignis empfängt.

Wenn das Betriebssystem einen Prozess herunterfährt, benachrichtigt es alle anderen Prozesse, die registrierte Handler für das Exited-Ereignis haben. Zu diesem Zeitpunkt kann das Handle des soeben beendeten Prozesses verwendet werden, um auf einige Eigenschaften zuzugreifen, z ExitTime . B. das HasExited Betriebssystem, bis es vollständig freigegeben wird.

Hinweis

Auch wenn Sie über ein Handle für einen beendeten Prozess verfügen, können Sie nicht erneut aufrufen Start , um die Verbindung mit demselben Prozess wiederherzustellen. Durch das Aufrufen Start wird der zugeordnete Prozess automatisch freigegeben und eine Verbindung mit einem Prozess mit derselben Datei hergestellt, aber eine völlig neue HandleDatei.

Weitere Informationen zur Verwendung des Exited Ereignisses in Windows Forms-Anwendungen finden Sie in der SynchronizingObject Eigenschaft.