Process.PriorityClass プロパティ

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.Process.dll

ソース:

Process.cs

関連付けられたプロセスの全体的な優先順位カテゴリを取得または設定します。

public System.Diagnostics.ProcessPriorityClass PriorityClass { get; set; }

プロパティ値

ProcessPriorityClass

プロセスの BasePriority を計算するときに使用する、関連付けられたプロセスの優先順位カテゴリ。

例外

Win32Exception

関連付けられているプロセスのリソースからプロセス優先度情報を設定できないか、取得できませんでした。

または

プロセス識別子またはプロセス ハンドルが 0 です。 (プロセスは開始されていません。)

NotSupportedException

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

InvalidOperationException

プロセス Id が使用できません。

InvalidEnumArgumentException

ProcessPriorityClass 列挙体で定義されている有効な値が使用されていないため、優先度クラスを設定できません。

例

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

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}");
            }
        }
    }
}

注釈

このプロパティによって返される値は、プロセスの最後に更新された優先度を表します。 最新の優先度を取得するには、まずメソッドを呼び出す Refresh() 必要があります。

プロセス優先度クラスには、スレッドの優先度レベルの範囲が含まれます。 プロセスで実行されている優先順位が異なるスレッドは、プロセスの優先度クラスを基準にして実行されます。 Win32 では、クラスごとに 7 つの基本優先度レベルを持つ 4 つの優先度クラスが使用されます。 これらのプロセス優先度クラスは列挙でProcessPriorityClassキャプチャされ、プロセスの優先順位を 、、Normal、High、AboveNormalBelowNormal、または RealTimeにIdle設定できます。 経過時間やその他のブーストに基づいて、プロセッサにアクセスするためにプロセスを他のプロセスよりも優先する必要がある場合に、オペレーティング システムによって基本優先度レベルを変更できます。 さらに、 を PriorityBoostEnabled 設定して、待機状態から取り出されたスレッドの優先度レベルを一時的に高めることができます。 プロセスが待機状態に戻ると、優先度がリセットされます。

BasePriorityプロパティを使用すると、プロセスに割り当てられている開始優先度を表示できます。 ただし、読み取り専用であるため、 プロパティを BasePriority 使用してプロセスの優先順位を設定することはできません。 優先度を変更するには、 プロパティを PriorityClass 使用します。このプロパティは、プロセスの全体的な優先度カテゴリを取得または設定します。

優先度クラスは、システム モニターを使用して表示できません。 次の表に、 と PriorityClass の値の関係をBasePriority示します。

BasePriority	PriorityClass
4	Idle
8	Normal
13	High
24	RealTime

適用対象

こちらもご覧ください

• BasePriority
• PriorityBoostEnabled