Process.EnableRaisingEvents Proprietà

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Source:

Process.cs

Ottiene o imposta la generazione dell'evento Exited quando il processo viene terminato.

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

Valore della proprietà

Boolean

true se l'evento Exited dovrà essere generato quando il processo associato viene terminato (mediante un'uscita o una chiamata al metodo Kill()); in caso contrario, false. Il valore predefinito è false. Si noti che anche se il valore di EnableRaisingEvents è false, l'evento Exited verrà generato dalla funzione di accesso della HasExited proprietà, se determina che il processo è stato chiuso.

Esempio

Nell'esempio di codice seguente viene creato un processo che stampa un file. Imposta la EnableRaisingEvents proprietà per fare in modo che il processo generi l'evento Exited quando viene chiuso. Il Exited gestore eventi visualizza le informazioni sul processo.

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

Commenti

La EnableRaisingEvents proprietà suggerisce se il componente deve ricevere una notifica quando il sistema operativo ha arrestato un processo. La EnableRaisingEvents proprietà viene utilizzata nell'elaborazione asincrona per notificare all'applicazione che un processo è stato chiuso. Per forzare l'applicazione a attendere in modo sincrono un evento di uscita (che interrompe l'elaborazione dell'applicazione fino a quando non si è verificato l'evento di uscita), usare il WaitForExit metodo .

Nota

Se si usa Visual Studio e si fa doppio clic su un componente nel progetto, viene generato automaticamente un Process delegato di evento e un Exited gestore eventi. Il codice aggiuntivo imposta la EnableRaisingEvents proprietà su false. È necessario modificare questa proprietà in true affinché il gestore eventi venga eseguito all'uscita dal processo associato.

Se il valore del EnableRaisingEvents componente è trueo quando EnableRaisingEvents è false e viene richiamato un HasExited controllo dal componente, il componente può accedere alle informazioni amministrative per il processo associato, che rimane archiviato dal sistema operativo. Tali informazioni includono ExitTime e ExitCode.

Al termine del processo associato, l'oggetto Handle del componente non punta più a una risorsa di processo esistente. Al contrario, può essere usato solo per accedere alle informazioni del sistema operativo sulla risorsa di processo. Il sistema operativo è consapevole che esistono handle per i processi chiusi che non sono stati rilasciati dai Process componenti, in modo da mantenere le ExitTime informazioni e Handle in memoria.

C'è un costo associato alla verifica della chiusura di un processo. Se EnableRaisingEvents è true, l'evento Exited viene generato quando il processo associato termina. Le procedure per l'esecuzione dell'evento Exited in quel momento.

In alcuni casi, l'applicazione avvia un processo, ma non richiede la notifica della chiusura. Ad esempio, l'applicazione può avviare blocco note per consentire all'utente di eseguire la modifica del testo, ma non usare ulteriormente l'applicazione Blocco note. È possibile scegliere di evitare la notifica quando il processo viene chiuso perché non è rilevante per l'operazione continua dell'applicazione. L'impostazione EnableRaisingEvents su false può salvare le risorse di sistema.

Vedi anche

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