Process.Exited Událost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Zdroj:

Process.cs

Nastane při ukončení procesu.

public:
 event EventHandler ^ Exited;

public event EventHandler Exited;

member this.Exited : EventHandler 

Public Custom Event Exited As EventHandler 

Event Type

EventHandler

Příklady

Následující příklad kódu vytvoří proces, který vytiskne soubor. Vyvolá událost při Exited ukončení procesu, protože EnableRaisingEvents vlastnost byla nastavena při vytvoření procesu. Obslužná rutina Exited události zobrazí informace o procesu.

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

Poznámky

Událost Exited označuje, že přidružený proces byl ukončen. Tento výskyt znamená, že se proces buď ukončil (přerušil) nebo se úspěšně ukončil. K této události může dojít pouze v případě, že hodnota EnableRaisingEvents vlastnosti je true.

Existují dva způsoby, jak být upozorněni na ukončení přidruženého procesu: synchronně a asynchronně. Synchronní oznámení znamená volání WaitForExit metody, která zablokuje aktuální vlákno, dokud se proces neskonjde. Asynchronní oznámení používá Exited událost, která umožňuje volající vlákno mezitím pokračovat v provádění. V druhém případě EnableRaisingEvents musí být nastavena na, aby true volající aplikace přijímala událost Exited.

Když operační systém vypne proces, upozorní všechny ostatní procesy, které mají zaregistrované obslužné rutiny pro událost Exited. V tuto chvíli je možné použít popisovač právě ukončeného procesu pro přístup k některým vlastnostem, jako ExitTime je a HasExited které operační systém udržuje, dokud tento popisovač úplně nespouští.

Poznámka

I když máte popisovač ukončeného procesu, nemůžete volat Start znovu a znovu se připojit ke stejnému procesu. Volání Start automaticky uvolní přidružený proces a připojí se k procesu se stejným souborem, ale zcela novým Handle.

Další informace o použití události v aplikacích Exited model Windows Forms najdete ve SynchronizingObject vlastnosti .