Process.EnableRaisingEvents Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Quelle:

Process.cs

Ruft ab oder legt fest, ob beim Beenden des Prozesses das Exited-Ereignis ausgelöst werden soll.

public:
 property bool EnableRaisingEvents { bool get(); void set(bool value); };

public bool EnableRaisingEvents { get; set; }

member this.EnableRaisingEvents : bool with get, set

Public Property EnableRaisingEvents As Boolean

Eigenschaftswert

Boolean

true, wenn das Exited-Ereignis ausgelöst werden soll, wenn der zugeordnete Prozess beendet wird (entweder durch Beenden oder einen Aufruf von Kill()), andernfalls false. Der Standardwert ist false. Beachten Sie, dass selbst wenn der Wert von EnableRaisingEvents ist false, das Exited Ereignis vom HasExited Eigenschaftszugriffsor ausgelöst wird, wenn festgestellt wird, dass der Prozess beendet wurde.

Beispiele

Im folgenden Codebeispiel wird ein Prozess erstellt, der eine Datei ausgibt. Die -Eigenschaft wird so festgelegt EnableRaisingEvents , dass der Prozess das Exited Ereignis auslöst, wenn er beendet wird. 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

Die EnableRaisingEvents -Eigenschaft schlägt vor, ob die Komponente benachrichtigt werden soll, wenn das Betriebssystem einen Prozess heruntergefahren hat. Die EnableRaisingEvents -Eigenschaft wird in der asynchronen Verarbeitung verwendet, um Ihre Anwendung darüber zu benachrichtigen, dass ein Prozess beendet wurde. Verwenden Sie die WaitForExit -Methode, um zu erzwingen, dass Ihre Anwendung synchron auf ein Exitereignis wartet (das die Verarbeitung der Anwendung unterbricht, bis das Exitereignis aufgetreten ist).

Hinweis

Wenn Sie Visual Studio verwenden und auf eine Process Komponente in Ihrem Projekt doppelklicken, werden automatisch ein Ereignisdelegat und ein Exited Ereignishandler generiert. Zusätzlicher Code legt die EnableRaisingEvents -Eigenschaft auf fest false. Sie müssen diese Eigenschaft in ändern, true damit Ihr Ereignishandler ausgeführt wird, wenn der zugeordnete Prozess beendet wird.

Wenn der Wert der Komponente EnableRaisingEvents ist trueoder ist EnableRaisingEventsfalse und eine HasExited Überprüfung von der Komponente aufgerufen wird, kann die Komponente auf die administrativen Informationen für den zugeordneten Prozess zugreifen, die vom Betriebssystem gespeichert bleiben. Zu diesen Informationen gehören die ExitTime und die ExitCode.

Nachdem der zugeordnete Prozess beendet wurde, verweist der Handle der Komponente nicht mehr auf eine vorhandene Prozessressource. Stattdessen kann sie nur verwendet werden, um auf die Informationen des Betriebssystems über die Prozessressource zuzugreifen. Das Betriebssystem ist sich bewusst, dass es Handles für beendete Prozesse gibt, die nicht von Process Komponenten freigegeben wurden, sodass es die ExitTime Informationen und Handle im Arbeitsspeicher behält.

Mit der Überwachung für das Beenden eines Prozesses sind Kosten verbunden. Wenn EnableRaisingEvents ist true, wird das Exited -Ereignis ausgelöst, wenn der zugeordnete Prozess beendet wird. Ihre Prozeduren für das Exited Ereignis werden zu diesem Zeitpunkt ausgeführt.

Manchmal startet Ihre Anwendung einen Prozess, erfordert jedoch keine Benachrichtigung über ihre Schließung. Beispielsweise kann Ihre Anwendung Editor starten, um dem Benutzer die Textbearbeitung zu ermöglichen, aber die Editor-Anwendung nicht weiter zu verwenden. Sie können eine Benachrichtigung vermeiden, wenn der Prozess beendet wird, da er für den fortgesetzten Betrieb Ihrer Anwendung nicht relevant ist. Wenn Sie auf festlegen EnableRaisingEvents , false können Sie Systemressourcen sparen.

Weitere Informationen

• WaitForExit(Int32)
• Exited
• CloseMainWindow()
• Kill()
• Handle
• ExitTime
• HasExited