Process.EnableRaisingEvents Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.Process.dll

Zdroj:

Process.cs

Získá nebo nastaví, zda Exited má být událost vyvolána při ukončení 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

Hodnota vlastnosti

Boolean

true Exited pokud má být událost vyvolána při ukončení přidruženého procesu (buď prostřednictvím ukončení, nebo volání Kill()); jinak , false. Výchozí hodnota je false. Všimněte si, že i když je falsehodnota EnableRaisingEvents , Exited událost bude vyvolána přistupovacím objektem HasExited vlastnosti, pokud zjistí, že proces byl ukončen.

Příklady

Následující příklad kódu vytvoří proces, který vytiskne soubor. EnableRaisingEvents Nastaví vlastnost tak, aby proces vyvolal Exited událost při jejím ukončení. 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]);
    }
}

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

Poznámky

Vlastnost EnableRaisingEvents naznačuje, zda má být komponenta upozorněna, když operační systém vypnul proces. Vlastnost EnableRaisingEvents se používá v asynchronním zpracování k upozornění aplikace, že proces byl ukončen. Pokud chcete vynutit synchronní čekání aplikace na výstupní událost (která přeruší zpracování aplikace, dokud nedojde k výstupní události), použijte metodu WaitForExit .

Poznámka:

Pokud používáte Sadu Visual Studio a dvakrát kliknete na komponentu Process v projektu, Exited vygeneruje se automaticky delegát události a obslužná rutina události. Další kód nastaví EnableRaisingEvents vlastnost na false. Tuto vlastnost musíte změnit na true obslužnou rutinu události, aby se spustila při ukončení přidruženého procesu.

Pokud je hodnota komponenty EnableRaisingEvents nebo pokud EnableRaisingEvents je false a HasExited je vyvolána kontrolou, může komponenta získat přístup k informacím o správě přidruženého procesu, který zůstává uložený operačním systémem.true Tyto informace zahrnují tyto ExitTime informace a ExitCode

Po ukončení Handle přidruženého procesu přestane komponenta odkazovat na existující prostředek procesu. Místo toho se dá použít pouze pro přístup k informacím operačního systému o prostředku procesu. Operační systém ví, že existují popisovače ukončovaných procesů, které nebyly uvolněny komponentami Process , takže uchovává ExitTime informace a Handle informace v paměti.

Existují náklady spojené s sledováním procesu, který se má ukončit. Pokud EnableRaisingEvents je true, Exited událost je vyvolána při ukončení přidruženého procesu. Vaše postupy pro Exited spuštění události v té době.

Aplikace někdy spustí proces, ale nevyžaduje oznámení o jejím uzavření. Vaše aplikace může například spustit Poznámkový blok, aby uživatel mohl provádět úpravy textu, ale nepoužívat aplikaci Poznámkový blok. Pokud se proces ukončí, můžete se vyhnout oznámení, protože není relevantní pro pokračování provozu vaší aplikace. Nastavení EnableRaisingEvents pro false ukládání systémových prostředků

Viz také

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