Process.Exited Ereignis

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Quelle:

Process.cs

Tritt beim Beenden eines Prozesses ein.

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. Es löst das Exited -Ereignis aus, wenn der Prozess beendet wird, da die EnableRaisingEvents -Eigenschaft festgelegt wurde, als der Prozess erstellt 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]);
    }
}

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 ist 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, das es dem aufrufenden Thread ermöglicht, die Ausführung in der Zwischenzeit fortzusetzen. Im letzteren Fall muss auf true festgelegt werden, EnableRaisingEvents damit die aufrufende Anwendung das Exited-Ereignis empfängt.

Wenn das Betriebssystem einen Prozess herunterfährt, benachrichtigt es alle anderen Prozesse, die über registrierte Handler für das Exited-Ereignis verfügen. Zu diesem Zeitpunkt kann das Handle des Prozesses, der gerade beendet wurde, für den Zugriff auf einige Eigenschaften wie ExitTime und HasExited verwendet werden, die das Betriebssystem verwaltet, bis es das Handle vollständig freigibt.

Hinweis

Selbst 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. Beim Aufrufen Start wird automatisch der zugeordnete Prozess freigegeben und eine Verbindung mit einem Prozess mit derselben Datei, aber einem völlig neuen Handlehergestellt.

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