Process.EnableRaisingEvents Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Zdroj:

Process.cs

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

trueExited pokud má být událost vyvolána při ukončení přidruženého procesu (ukončením nebo voláním Kill()příkazu ); v opačném případě false. Výchozí formát je false. Všimněte si, že i v případě, že hodnota EnableRaisingEvents je false, Exited bude událost vyvolána přistupovacím HasExited objektem vlastnosti, pokud určí, že proces byl ukončen.

Příklady

Následující příklad kódu vytvoří proces, který vytiskne soubor. Nastaví EnableRaisingEvents vlastnost tak, aby způsobila, že proces vyvolá 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]);
    }
}

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 navrhuje, jestli 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, aby aplikace synchronně čekala na událost ukončení (která přeruší zpracování aplikace, dokud nedojde k události ukončení), použijte metodu WaitForExit .

Poznámka

Pokud používáte sadu Visual Studio a poklikejte na komponentu Process v projektu, Exited automaticky se vygeneruje 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, aby true se obslužná rutina události spustila při ukončení přidruženého procesu.

Pokud je truehodnota komponenty EnableRaisingEvents , nebo pokud EnableRaisingEvents je falseHasExited vyvolána kontrola komponentou, má komponenta přístup k informacím o správě přidruženého procesu, které zůstávají uložené operačním systémem. Mezi tyto informace patří ExitTime 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 si je vědom, že existují popisovače pro ukončené procesy, které nebyly uvolněny komponentami Process , takže uchovává ExitTime informace a Handle v paměti.

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

Někdy aplikace spustí proces, ale nevyžaduje oznámení o jeho uzavření. Aplikace může například spustit Poznámkový blok, aby uživatel mohl provádět úpravy textu, ale aplikaci Poznámkový blok už dál nepoužít. Můžete se rozhodnout, že se chcete vyhnout oznámením o ukončení procesu, protože to není relevantní pro pokračování provozu vaší aplikace. Nastavení EnableRaisingEvents na může false šetřit systémové prostředky.

Viz také

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