Process.Exited Ereignis

Definition

Tritt beim Beenden eines Prozesses ein.Occurs when a process exits.

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 ausgibt.The following code example creates a process that prints a file. Das-Ereignis wird ausgelöst, Exited Wenn der Prozess beendet wird, da die- EnableRaisingEvents Eigenschaft beim Erstellen des Prozesses festgelegt wurde.It raises the Exited event when the process exits because the EnableRaisingEvents property was set when the process was created. Der Exited Ereignishandler zeigt Prozessinformationen an.The Exited event handler displays process information.

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]);
    }
}
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.The Exited event indicates that the associated process exited. Dieses Vorkommen bedeutet, dass der Prozess beendet (abgebrochen) oder erfolgreich geschlossen wurde.This occurrence means either that the process terminated (aborted) or successfully closed. Dieses Ereignis kann nur auftreten, wenn der Wert der- EnableRaisingEvents Eigenschaft ist true .This event can occur only if the value of the EnableRaisingEvents property is true.

Es gibt zwei Möglichkeiten, benachrichtigt zu werden, wenn der zugehörige Prozess beendet wird: synchron und asynchron.There are two ways of being notified when the associated process exits: synchronously and asynchronously. Synchrone Benachrichtigung bedeutet, dass die-Methode aufgerufen wird WaitForExit , um den aktuellen Thread zu blockieren, bis der Prozess beendetSynchronous notification means calling the WaitForExit method to block the current thread until the process exits. Die asynchrone Benachrichtigung verwendet das- Exited Ereignis, mit dem der aufrufende Thread in der Zwischenzeit die Ausführung fortsetzen kann.Asynchronous notification uses the Exited event, which allows the calling thread to continue execution in the meantime. Im letzteren Fall EnableRaisingEvents muss auf festgelegt werden, true damit die aufrufende Anwendung das Ereignis, das beendet wird, empfängt.In the latter case, EnableRaisingEvents must be set to true for the calling application to receive the Exited event.

Wenn das Betriebssystem einen Prozess herunterfährt, werden alle anderen Prozesse benachrichtigt, die über registrierte Handler für das Ereignis "beendet" verfügen.When the operating system shuts down a process, it notifies all other processes that have registered handlers for the Exited event. Zu diesem Zeitpunkt kann das Handle des soeben abzurufenden Prozesses für den Zugriff auf einige Eigenschaften wie und verwendet ExitTime werden HasExited , die vom Betriebssystem verwaltet werden, bis es das Handle vollständig freigibt.At this time, the handle of the process that just exited can be used to access some properties such as ExitTime and HasExited that the operating system maintains until it releases that handle completely.

Hinweis

Auch wenn Sie über ein Handle für einen vorhandenen Prozess verfügen, können Sie keinen erneuten Rückruf ausführen, Start um die Verbindung mit dem gleichen Prozess wiederherzustellen.Even if you have a handle to an exited process, you cannot call Start again to reconnect to the same process. Durch den Aufruf von wird der zugeordnete Start Prozess automatisch freigegeben, und es wird eine Verbindung mit einem Prozess hergestellt HandleCalling Start automatically releases the associated process and connects to a process with the same file but an entirely new Handle.

Weitere Informationen zur Verwendung des Exited Ereignisses in Windows Forms Anwendungen finden Sie unter der- SynchronizingObject Eigenschaft.For more information about the use of the Exited event in Windows Forms applications, see the SynchronizingObject property.

Gilt für: