Process.EnableRaisingEvents Properti

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

netstandard.dll, System.Diagnostics.Process.dll

Sumber:

Process.cs

Mendapatkan atau mengatur apakah Exited peristiwa harus dinaikkan saat proses berakhir.

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

Nilai Properti

Boolean

true Exited jika peristiwa harus dinaikkan ketika proses terkait dihentikan (melalui pintu keluar atau panggilan ke Kill()); jika tidak, false. Defaultnya adalah false. Perhatikan bahwa bahkan jika nilainya EnableRaisingEvents adalah false, Exited peristiwa akan dinaikkan oleh HasExited aksesor properti, jika menentukan bahwa proses telah keluar.

Contoh

Contoh kode berikut membuat proses yang mencetak file. Ini mengatur EnableRaisingEvents properti untuk menyebabkan proses menaikkan Exited peristiwa saat keluar. Penanganan Exited aktivitas menampilkan informasi proses.

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

Keterangan

Properti EnableRaisingEvents menyarankan apakah komponen harus diberi tahu ketika sistem operasi telah mematikan proses. Properti EnableRaisingEvents digunakan dalam pemrosesan asinkron untuk memberi tahu aplikasi Anda bahwa proses telah keluar. Untuk memaksa aplikasi Anda menunggu peristiwa keluar secara sinkron (yang mengganggu pemrosesan aplikasi hingga peristiwa keluar terjadi), gunakan WaitForExit metode .

Nota

Jika Anda menggunakan Visual Studio dan mengeklik Process dua kali komponen dalam proyek Anda, Exited delegasi peristiwa dan penanganan aktivitas akan dibuat secara otomatis. Kode tambahan mengatur properti ke EnableRaisingEventsfalse. Anda harus mengubah properti ini ke agar true penanganan aktivitas Anda dijalankan ketika proses terkait keluar.

Jika nilai komponen EnableRaisingEvents adalah true, atau kapan EnableRaisingEvents dan falseHasExited pemeriksaan dipanggil oleh komponen, komponen dapat mengakses informasi administratif untuk proses terkait, yang tetap disimpan oleh sistem operasi. Informasi tersebut ExitTime mencakup dan ExitCode.

Setelah proses terkait keluar, Handle komponen tidak lagi menunjuk ke sumber daya proses yang ada. Sebaliknya, ini hanya dapat digunakan untuk mengakses informasi sistem operasi tentang sumber daya proses. Sistem operasi menyadari bahwa ada penanganan untuk proses yang keluar yang belum dirilis oleh Process komponen, sehingga menyimpan ExitTime informasi dan Handle dalam memori.

Ada biaya yang terkait dengan menonton proses untuk keluar. Jika EnableRaisingEvents adalah true, Exited peristiwa dinaikkan ketika proses terkait berakhir. Prosedur Anda untuk peristiwa berjalan Exited pada saat itu.

Terkadang, aplikasi Anda memulai proses tetapi tidak memerlukan pemberitahuan tentang penutupannya. Misalnya, aplikasi Anda dapat memulai Notepad untuk memungkinkan pengguna melakukan pengeditan teks tetapi tidak menggunakan aplikasi Notepad lebih lanjut. Anda dapat memilih untuk menghindari pemberitahuan ketika proses keluar karena tidak relevan dengan operasi berkelanjutan aplikasi Anda. Pengaturan EnableRaisingEvents ke false dapat menyimpan sumber daya sistem.

Lihat juga

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