Process.ExitCode プロパティ

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.Process.dll

ソース:

Process.cs

関連付けられたプロセスが終了したときにプロセスによって指定された値を取得します。

public int ExitCode { get; }

プロパティ値

Int32

関連付けられたプロセスが終了したときにプロセスによって指定されたコード。

例外

InvalidOperationException

プロセスは終了していません。

または

プロセス Handle は終了していません。

NotSupportedException

リモート コンピューターで実行中のプロセスの ExitCode プロパティにアクセスしようとしています。 このプロパティはローカル コンピューターで実行中のプロセスに対してのみ使用可能です。

例

次の例では、メモ帳のインスタンスを開始します。 次に、この例では、関連付けられているプロセスのさまざまなプロパティを取得して表示します。 この例では、プロセスが終了したときにを検出し、プロセスの終了コードを表示します。

using System;
using System.Diagnostics;

namespace ProcessSample
{
    class ProcessMonitorSample
    {
        public static void Main()
        {
            // Define variables to track the peak
            // memory usage of the process.
            long peakPagedMem   = 0,
                 peakWorkingSet = 0,
                 peakVirtualMem = 0;

            // Start the process.
            using (Process myProcess = Process.Start("NotePad.exe"))
            {
                // Display the process statistics until
                // the user closes the program.
                do
                {
                    if (!myProcess.HasExited)
                    {
                        // Refresh the current process property values.
                        myProcess.Refresh();

                        Console.WriteLine();

                        // Display current process statistics.

                        Console.WriteLine($"{myProcess} -");
                        Console.WriteLine("-------------------------------------");

                        Console.WriteLine($"  Physical memory usage     : {myProcess.WorkingSet64}");
                        Console.WriteLine($"  Base priority             : {myProcess.BasePriority}");
                        Console.WriteLine($"  Priority class            : {myProcess.PriorityClass}");
                        Console.WriteLine($"  User processor time       : {myProcess.UserProcessorTime}");
                        Console.WriteLine($"  Privileged processor time : {myProcess.PrivilegedProcessorTime}");
                        Console.WriteLine($"  Total processor time      : {myProcess.TotalProcessorTime}");
                        Console.WriteLine($"  Paged system memory size  : {myProcess.PagedSystemMemorySize64}");
                        Console.WriteLine($"  Paged memory size         : {myProcess.PagedMemorySize64}");

                        // Update the values for the overall peak memory statistics.
                        peakPagedMem   = myProcess.PeakPagedMemorySize64;
                        peakVirtualMem = myProcess.PeakVirtualMemorySize64;
                        peakWorkingSet = myProcess.PeakWorkingSet64;

                        if (myProcess.Responding)
                        {
                            Console.WriteLine("Status = Running");
                        }
                        else
                        {
                            Console.WriteLine("Status = Not Responding");
                        }
                    }
                }
                while (!myProcess.WaitForExit(1000));

                Console.WriteLine();
                Console.WriteLine($"  Process exit code          : {myProcess.ExitCode}");

                // Display peak memory statistics for the process.
                Console.WriteLine($"  Peak physical memory usage : {peakWorkingSet}");
                Console.WriteLine($"  Peak paged memory usage    : {peakPagedMem}");
                Console.WriteLine($"  Peak virtual memory usage  : {peakVirtualMem}");
            }
        }
    }
}

注釈

システム プロセスが終了したときに返された状態を取得するには、 を使用 ExitCode します。 終了コードは、プロシージャからの main() 整数の戻り値と同じように使用できます。

プロセスの値は ExitCode 、そのプロセスに対してアプリケーション開発者によって実装された特定の規則を反映しています。 終了コード値を使用してコード内で決定を行う場合は、アプリケーション プロセスで使用される終了コード規則がわかっていることを確認してください。

開発者は通常、正常終了を ExitCode ゼロの値で示し、呼び出し元のメソッドが異常なプロセス終了の原因を特定するために使用できる 0 以外の値でエラーを指定します。 これらのガイドラインに従う必要はありませんが、規則です。

プロセスが終了する前に を ExitCode 取得しようとすると、例外がスローされます。 最初に プロパティを HasExited 調べて、関連付けられたプロセスが終了したかどうかを確認します。

注意

標準出力が非同期イベント ハンドラーにリダイレクトされると、 が返trueされたときにHasExited出力処理が完了していない可能性があります。 非同期イベント処理が完了したことを確認するには、 をチェックHasExitedする前にパラメーターをWaitForExit()受け取っていないオーバーロードを呼び出します。

または メソッドをCloseMainWindowKill使用して、関連付けられているプロセスを終了させることができます。

関連付けられたプロセスが終了したときに通知を受け取る方法は、同期と非同期の 2 つあります。 同期通知は、 メソッドを WaitForExit 呼び出して、関連付けられているコンポーネントが終了するまでアプリケーションの処理を一時停止します。 非同期通知は イベントに Exited 依存します。 非同期通知を使用する場合、EnableRaisingEventsプロセスが終了したことを示す通知をProcessコンポーネントが受信するには、 を にtrue設定する必要があります。

適用対象

こちらもご覧ください

• HasExited
• CloseMainWindow()
• Kill()
• WaitForExit(Int32)
• EnableRaisingEvents