Process.EnableRaisingEvents Свойство

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

public bool EnableRaisingEvents { get; set; }

[System.ComponentModel.Browsable(false)]
public bool EnableRaisingEvents { get; set; }

member this.EnableRaisingEvents : bool with get, set

[<System.ComponentModel.Browsable(false)>]
member this.EnableRaisingEvents : bool with get, set

Public Property EnableRaisingEvents As Boolean

Значение свойства

true Exited Значение , если событие должно возникать при завершении связанного процесса (через выход или вызовKill()); в противном случае false. Значение по умолчанию — false. Обратите внимание, что даже если значение EnableRaisingEvents равно false, Exited событие будет вызываться методом HasExited доступа к свойствам, если он определяет, что процесс завершился.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода создается процесс печати файла. Он задает EnableRaisingEvents свойство, чтобы процесс вызвал Exited событие при выходе. Обработчик Exited событий отображает сведения о процессе.

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]);
    }
}

open System
open System.Diagnostics
open System.Threading.Tasks

let mutable myProcess = new Process()
let mutable eventHandled = TaskCompletionSource<bool>()

// Handle Exited event and display process information.
let myProcess_Exited (sender: obj) (e: EventArgs) =
    printfn $"Exit time    : {myProcess.ExitTime}\n"
    printfn $"Exit code    : {myProcess.ExitCode}\n"
    printfn $"Elapsed time : {round ((myProcess.ExitTime - myProcess.StartTime).TotalMilliseconds)}"
    eventHandled.TrySetResult true |> ignore

// Print a file with any known extension.
let printDoc fileName =
    task {
        eventHandled <- TaskCompletionSource<bool>()

        use 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.AddHandler(EventHandler myProcess_Exited)
            myProcess.Start() |> ignore
        with ex ->
            printfn $"An error occurred trying to print \"{fileName}\":\n{ex.Message}"

        // Wait for Exited event, but not more than 30 seconds.
        let! _ = Task.WhenAny(eventHandled.Task, Task.Delay(30000))
        ()
    }

[<EntryPoint>]
let main args =
    // Verify that an argument has been entered.
    if args.Length <= 0 then
        printfn "Enter a file name."
    else
        // Create the process and print the document.
        printDoc(args[0]).Wait() |> ignore

    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

Комментарии

Свойство EnableRaisingEvents указывает, должен ли компонент получать уведомления о завершении процесса операционной системы. Свойство EnableRaisingEvents используется в асинхронной обработке для уведомления приложения о завершении процесса. Чтобы принудить приложение синхронно ожидать события выхода (который прерывает обработку приложения до тех пор, пока событие выхода не произошло), используйте WaitForExit этот метод.

Если значение компонента EnableRaisingEvents равно trueили EnableRaisingEvents когда оно HasExitedfalse вызывается компонентом, компонент может получить доступ к административной информации для связанного процесса, который сохраняется операционной системой. Такая информация включает в себя ExitTime и ExitCode.

После завершения Handle связанного процесса компонент больше не указывает на существующий ресурс процесса. Вместо этого он может использоваться только для доступа к сведениям операционной системы о ресурсе процесса. Операционная система знает, что существуют дескрипторы для выходных процессов, которые не были выпущены Process компонентами, поэтому он сохраняет HandleExitTime и информацию в памяти.

Существует стоимость, связанная с наблюдением за процессом выхода. Если EnableRaisingEvents это trueтак, Exited событие возникает при завершении связанного процесса. Процедуры выполнения Exited события в это время.

Иногда приложение запускает процесс, но не требует уведомления о его закрытии. Например, приложение может запустить Блокнот, чтобы разрешить пользователю выполнять редактирование текста, но не использовать приложение Блокнота. Вы можете избежать уведомления при выходе процесса из-за того, что оно не относится к непрерывной работе приложения. Параметр EnableRaisingEvents для false сохранения системных ресурсов.

См. также раздел

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