Process.EnableRaisingEvents Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Source:

Process.cs

Obtient ou définit une valeur indiquant si l'événement Exited est déclenché quand le processus ne s'exécute plus.

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é une fois que le processus associé n'est plus exécuté (sortie ou appel à Kill()) ; sinon, false. La valeur par défaut est false. Notez que même si la valeur de EnableRaisingEvents est false, l’événement Exited sera 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. Il définit la EnableRaisingEvents propriété de sorte que le processus déclenche l’événement à sa Exited sortie. Le Exited gestionnaire d’événements affiche des 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]);
    }
}

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 EnableRaisingEvents propriété est utilisée dans le traitement asynchrone pour informer votre application qu’un processus s’est arrêté. 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 se soit produit), utilisez la WaitForExit méthode .

Notes

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

Si la valeur du EnableRaisingEvents composant est true, ou si est false et qu’une EnableRaisingEventsHasExited case activée 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 le ExitTime et le ExitCode.

Une fois le processus associé terminé, le Handle du 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 les processus arrêtés qui n’ont pas été libérés par Process les composants, de sorte qu’il conserve les ExitTime informations et Handle en mémoire.

Un coût est associé à l’observation d’un processus à quitter. Si EnableRaisingEvents a la valeur true, l’événement Exited est déclenché lorsque le processus associé se termine. Vos procédures pour l’événement s’exécutent 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 des modifications de texte, mais ne plus utiliser l’application Bloc-notes. Vous pouvez choisir d’éviter la notification lorsque le processus se termine, car elle n’est pas pertinente pour le fonctionnement continu de votre application. La définition de EnableRaisingEvents sur false peut économiser des ressources système.

Voir aussi

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