Process.EnableRaisingEvents Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.Process.dll

Źródło:

Process.cs

Pobiera lub ustawia, Exited czy zdarzenie powinno być zgłaszane po zakończeniu procesu.

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

Wartość właściwości

Boolean

true jeśli zdarzenie powinno zostać podniesione po zakończeniu Exited skojarzonego procesu (za pośrednictwem zakończenia lub wywołania metody Kill()); w przeciwnym razie false. Wartość domyślna to false. Należy pamiętać, że nawet jeśli wartość EnableRaisingEvents to false, Exited zdarzenie zostanie zgłoszone przez metodę HasExited dostępu właściwości, jeśli określi, że proces zakończył się.

Przykłady

Poniższy przykład kodu tworzy proces, który drukuje plik. Ustawia EnableRaisingEvents właściwość , aby spowodować, że proces zgłosi zdarzenie po jego zakończeniu Exited . Program Exited obsługi zdarzeń wyświetla informacje o procesie.

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

Uwagi

Właściwość EnableRaisingEvents sugeruje, czy składnik powinien zostać powiadomiony, gdy system operacyjny zamknął proces. Właściwość EnableRaisingEvents jest używana w przetwarzaniu asynchronicznym w celu powiadamiania aplikacji o zakończeniu procesu. Aby wymusić synchroniczne oczekiwanie aplikacji na zdarzenie zakończenia (które przerywa przetwarzanie aplikacji do momentu wystąpienia zdarzenia zakończenia), użyj WaitForExit metody .

Uwaga

Jeśli używasz programu Visual Studio i klikasz Process dwukrotnie składnik w projekcie, Exited zostanie automatycznie wygenerowany delegat zdarzenia i procedura obsługi zdarzeń. Dodatkowy kod ustawia EnableRaisingEvents właściwość na false. Należy zmienić tę właściwość na , aby true program obsługi zdarzeń był wykonywany po zakończeniu skojarzonego procesu.

Jeśli wartość składnika EnableRaisingEvents to true, lub gdy EnableRaisingEvents jest false i HasExited sprawdzanie jest wywoływane przez składnik, składnik może uzyskać dostęp do informacji administracyjnych dotyczących skojarzonego procesu, który pozostaje przechowywany przez system operacyjny. Takie informacje obejmują elementy ExitTime i ExitCode.

Po zakończeniu Handle skojarzonego procesu składnik nie wskazuje już istniejącego zasobu procesu. Zamiast tego można go używać tylko do uzyskiwania dostępu do informacji o zasobie procesu systemu operacyjnego. System operacyjny zdaje sobie sprawę, że istnieją dojścia do procesów, które nie zostały zwolnione przez Process składniki, więc przechowuje ExitTime informacje i Handle w pamięci.

Istnieje koszt związany z obserwowaniem zakończenia procesu. Jeśli EnableRaisingEvents parametr ma truewartość , Exited zdarzenie jest zgłaszane po zakończeniu skojarzonego procesu. Procedury dotyczące zdarzenia Exited są uruchamiane w tym czasie.

Czasami aplikacja uruchamia proces, ale nie wymaga powiadomienia o jego zamknięciu. Na przykład aplikacja może uruchomić Notatnik, aby zezwolić użytkownikowi na edytowanie tekstu, ale nie będzie korzystać z aplikacji Notatnika. Możesz uniknąć powiadomienia, gdy proces zakończy działanie, ponieważ nie ma znaczenia dla ciągłej pracy aplikacji. Ustawienie EnableRaisingEvents w celu false zapisania zasobów systemowych.

Zobacz też

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