Process.EnableRaisingEvents Özellik

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Diagnostics.Process.dll

Kaynak:

Process.cs

İşlem sonlandırıldığında olayın tetiklenip tetiklenmemesi gerektiğini alır veya ayarlar Exited .

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

Özellik Değeri

Boolean

true İlişkili Exited işlem sonlandırıldığında olayın tetiklenmesi gerekiyorsa (bir çıkış veya çağrısı Kill()yoluyla); aksi takdirde , false. Varsayılan değer: false. değeri EnableRaisingEvents olsa falseExited bile, işlemden çıkıldığını belirlerse olayın özellik erişimcisi tarafından HasExited tetikleneceğini unutmayın.

Örnekler

Aşağıdaki kod örneği, bir dosyayı yazdıran bir işlem oluşturur. Özelliği, EnableRaisingEvents çıkış sırasında işlemin olayı tetiklesine Exited neden olacak şekilde ayarlar. Olay işleyicisi Exited işlem bilgilerini görüntüler.

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

Açıklamalar

özelliği, EnableRaisingEvents işletim sistemi bir işlemi kapattığında bileşenin bilgilendirilip bildirilmeyeceğini önerir. EnableRaisingEvents özelliği, uygulamanıza bir işlemden çıkıldığını bildirmek için zaman uyumsuz işlemede kullanılır. Uygulamanızı zaman uyumlu bir şekilde çıkış olayını beklemeye zorlamak için (çıkış olayı gerçekleşene kadar uygulamanın işlenmesini kesintiye WaitForExit uğratan), yöntemini kullanın.

Uyarı

Visual Studio kullanıyorsanız ve projenizdeki bir Process bileşene çift tıklarsanız, otomatik olarak bir Exited olay temsilcisi ve olay işleyicisi oluşturulur. Ek kod özelliğini olarak EnableRaisingEventsfalseayarlar. İlişkili işlem çıktığında olay işleyicinizin yürütülmesi için bu özelliği true olarak değiştirmeniz gerekir.

Bileşenin EnableRaisingEvents değeri ise trueveya olduğunda falseEnableRaisingEvents ve bileşen tarafından bir HasExited denetim çağrıldığında, bileşen işletim sistemi tarafından depolanan ilişkili işlemin yönetim bilgilerine erişebilir. Bu bilgiler ve ExitCodebilgilerini içerirExitTime.

İlişkili işlem çıktıktan sonra, Handle bileşenin bileşeni artık var olan bir işlem kaynağını işaret etmemektedir. Bunun yerine, yalnızca işletim sisteminin işlem kaynağı hakkındaki bilgilerine erişmek için kullanılabilir. İşletim sistemi, bileşenler tarafından Process yayımlanmamış olan çıkışlı işlemlerin tanıtıcıları olduğunu algılar, bu nedenle ve Handle bilgilerini bellekte tutarExitTime.

Bir işlemin çıkışının izlenmesiyle ilişkili bir maliyet vardır. ise EnableRaisingEventstrue, Exited ilişkili işlem sonlandırıldığında olay oluşturulur. Olayla ilgili Exited yordamlarınız o anda çalıştırılır.

Bazen uygulamanız bir işlem başlatır ancak kapatılacağının bildirilmesi gerekmez. Örneğin, uygulamanız kullanıcının metin düzenleme gerçekleştirmesine izin vermek için Not Defteri'ni başlatabilir ancak Not Defteri uygulamasını başka bir şekilde kullanmaz. Uygulamanızın devam eden işlemiyle ilgili olmadığından işlemden çıkıldığında bildirimden kaçınmayı seçebilirsiniz. ayarı EnableRaisingEventsfalse sistem kaynaklarını kaydedebilir.

Ayrıca bkz.

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