Process.EnableRaisingEvents Propriété

Définition

Espace de noms:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.Process.dll

Source:

Process.cs

Obtient ou définit si l’événement Exited doit être déclenché lorsque le processus se termine.

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

Valeur de propriété

Boolean

true si l’événement Exited doit être déclenché lorsque le processus associé est arrêté (par le biais d’une sortie ou d’un appel à Kill()) ; sinon, false. La valeur par défaut est false. Notez que même si la valeur est EnableRaisingEventsfalse, l’événement Exited est déclenché par l’accesseur HasExited de propriété, s’il détermine que le processus a quitté.

Exemples

L’exemple de code suivant crée un processus qui imprime un fichier. Elle définit la propriété pour que le EnableRaisingEvents processus déclenche l’événement Exited lorsqu’il se termine. Le Exited gestionnaire d’événements affiche les informations de processus.

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

Remarques

La EnableRaisingEvents propriété indique si le composant doit être averti lorsque le système d’exploitation a arrêté un processus. La propriété est utilisée dans le EnableRaisingEvents traitement asynchrone pour informer votre application qu’un processus a quitté. Pour forcer votre application à attendre de manière synchrone un événement de sortie (qui interrompt le traitement de l’application jusqu’à ce que l’événement de sortie ait eu lieu), utilisez la WaitForExit méthode.

Note

Si vous utilisez Visual Studio et double-cliquez sur un Process composant dans votre projet, un délégué d’événement et un gestionnaire d’événements Exited sont générés automatiquement. Le code supplémentaire définit la EnableRaisingEvents propriété sur false. Vous devez modifier cette propriété true pour que votre gestionnaire d’événements s’exécute lorsque le processus associé quitte.

Si la valeur du EnableRaisingEvents composant est true, ou quand et qu’une HasExitedEnableRaisingEventsfalse vérification est appelée par le composant, le composant peut accéder aux informations d’administration du processus associé, qui restent stockées par le système d’exploitation. Ces informations incluent les ExitTime et les ExitCode.

Une fois le processus associé terminé, le Handle composant ne pointe plus vers une ressource de processus existante. Au lieu de cela, il peut uniquement être utilisé pour accéder aux informations du système d’exploitation sur la ressource de processus. Le système d’exploitation est conscient qu’il existe des handles pour quitter les processus qui n’ont pas été libérés par Process les composants, de sorte qu’il conserve les informations et Handle les ExitTime informations en mémoire.

Il existe un coût associé à la surveillance d’un processus de sortie. Si EnableRaisingEvents c’est truele cas, l’événement Exited est déclenché lorsque le processus associé se termine. Vos procédures pour l’exécution de l’événement Exited à ce moment-là.

Parfois, votre application démarre un processus, mais ne nécessite pas de notification de sa fermeture. Par exemple, votre application peut démarrer le Bloc-notes pour permettre à l’utilisateur d’effectuer une modification de texte, mais n’utilise pas davantage l’application Bloc-notes. Vous pouvez choisir d’éviter la notification lorsque le processus se termine, car il n’est pas pertinent pour l’opération continue de votre application. Paramètre EnableRaisingEvents permettant d’enregistrer false les ressources système.

Voir aussi

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