Process.Exited イベント

定義

プロセスが終了したときに発生します。Occurs when a process exits.

public:
 event EventHandler ^ Exited;
public event EventHandler Exited;
member this.Exited : EventHandler 
Public Custom Event Exited As EventHandler 

次のコード例では、ファイルを出力するプロセスを作成します。The following code example creates a process that prints a file. プロセスの作成時に EnableRaisingEvents プロパティが設定されていたため、プロセスが終了したときに Exited イベントが発生します。It raises the Exited event when the process exits because the EnableRaisingEvents property was set when the process was created. Exited イベントハンドラーには、プロセス情報が表示されます。The Exited event handler displays process information.

using System;
using System.Diagnostics;
using System.Threading;

class PrintProcessClass
{
    private Process myProcess;
    private int elapsedTime;
    private bool eventHandled;

    // Print a file with any known extension.
    public void PrintDoc(string fileName)
    {
        elapsedTime = 0;
        eventHandled = false;

        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.
            const int SleepAmount = 100;
            while (!eventHandled)
            {
                elapsedTime += SleepAmount;
                if (elapsedTime > 30000)
                {
                    break;
                }
                
                Thread.Sleep(SleepAmount);
            }
        }
    }

    // Handle Exited event and display process information.
    private void myProcess_Exited(object sender, System.EventArgs e)
    {
        eventHandled = true;
        Console.WriteLine(
            $"Exit time    : {myProcess.ExitTime}\n" +
            $"Exit code    : {myProcess.ExitCode}\n" +
            $"Elapsed time : {elapsedTime}");
    }

    public static void 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();
        myPrintProcess.PrintDoc(args[0]);
    }
}
Imports System.Diagnostics
Imports System.Threading

Class PrintProcessClass

    Private WithEvents myProcess As Process
    Private elapsedTime As Integer
    Private eventHandled As Boolean

    Public Event Exited As EventHandler

    ' Print a file with any known extension.
    Sub PrintDoc(ByVal fileName As String)

        elapsedTime = 0
        eventHandled = False

        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.Start()

            Catch ex As Exception
                Console.WriteLine("An error occurred trying to print ""{0}"":" &
                vbCrLf & ex.Message, fileName)
                Return
            End Try
        End Using

        ' Wait for Exited event, but not more than 30 seconds.
        Const SLEEP_AMOUNT As Integer = 100
        Do While Not eventHandled
            elapsedTime += SLEEP_AMOUNT
            If elapsedTime > 30000 Then
                Exit Do
            End If
            Thread.Sleep(SLEEP_AMOUNT)
        Loop
    End Sub

    ' Handle Exited event and display process information.
    Private Sub myProcess_Exited(ByVal sender As Object,
            ByVal e As System.EventArgs) Handles myProcess.Exited

        eventHandled = True
        Console.WriteLine("Exit time:    {0}" & vbCrLf &
            "Exit code:    {1}" & vbCrLf & "Elapsed time: {2}",
            myProcess.ExitTime, myProcess.ExitCode, elapsedTime)
    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))
    End Sub
End Class

注釈

Exited イベントは、関連付けられたプロセスが終了したことを示します。The Exited event indicates that the associated process exited. この現象は、プロセスが終了 (中止) されたか、または正常に終了したことを意味します。This occurrence means either that the process terminated (aborted) or successfully closed. このイベントは、EnableRaisingEvents プロパティの値が true場合にのみ発生します。This event can occur only if the value of the EnableRaisingEvents property is true.

関連付けられたプロセスが終了すると、同期的かつ非同期的に通知される2つの方法があります。There are two ways of being notified when the associated process exits: synchronously and asynchronously. 同期通知とは、プロセスが終了するまで、WaitForExit メソッドを呼び出して現在のスレッドをブロックすることを意味します。Synchronous notification means calling the WaitForExit method to block the current thread until the process exits. 非同期通知は、Exited イベントを使用します。これにより、呼び出し元のスレッドは、その間に実行を継続できます。Asynchronous notification uses the Exited event, which allows the calling thread to continue execution in the meantime. 後者の場合、呼び出し元のアプリケーションが終了イベントを受け取るには、EnableRaisingEventstrue に設定する必要があります。In the latter case, EnableRaisingEvents must be set to true for the calling application to receive the Exited event.

オペレーティングシステムは、プロセスをシャットダウンすると、終了したイベントに対してハンドラーが登録されている他のすべてのプロセスに通知します。When the operating system shuts down a process, it notifies all other processes that have registered handlers for the Exited event. 現時点では、終了したばかりのプロセスのハンドルを使用して、ExitTime などのいくつかのプロパティにアクセスしたり、そのハンドルを完全に解放するまでオペレーティングシステムが保持する HasExited したりできます。At this time, the handle of the process that just exited can be used to access some properties such as ExitTime and HasExited that the operating system maintains until it releases that handle completely.

注意

終了したプロセスへのハンドルがある場合でも、Start を再度呼び出して同じプロセスに再接続することはできません。Even if you have a handle to an exited process, you cannot call Start again to reconnect to the same process. Start を呼び出すと、関連付けられているプロセスが自動的に解放され、同じファイルを持つプロセスに接続しますが、完全に新しい Handleます。Calling Start automatically releases the associated process and connects to a process with the same file but an entirely new Handle.

Windows フォームアプリケーションでの Exited イベントの使用の詳細については、SynchronizingObject プロパティを参照してください。For more information about the use of the Exited event in Windows Forms applications, see the SynchronizingObject property.

セキュリティ

LinkDemand
直前の呼び出し元に対する完全な信頼の場合。for full trust for the immediate caller. このメンバーは、部分的に信頼されているコードから使用することはできません。This member cannot be used by partially trusted code.

適用対象