ThreadPriority 列挙型

定義

名前空間:

System.Threading

アセンブリ:

System.Threading.Thread.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

Thread のスケジューリング優先順位を指定します。

public enum class ThreadPriority

public enum ThreadPriority

[System.Serializable]
public enum ThreadPriority

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ThreadPriority

type ThreadPriority = 

[<System.Serializable>]
type ThreadPriority = 

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ThreadPriority = 

Public Enum ThreadPriority

継承

Object

ValueType

Enum

ThreadPriority

属性

SerializableAttribute ComVisibleAttribute

フィールド

AboveNormal	3	Thread は優先順位が Highest のスレッドから Normal のスレッドの間にスケジュールできます。
BelowNormal	1	Thread は優先順位が Normal のスレッドから Lowest のスレッドの間にスケジュールできます。
Highest	4	Thread は、どの優先順位のスレッドの前にでもスケジュールできます。
Lowest	0	Thread は、ほかのどの優先順位のスレッドの後でもスケジュールできます。
Normal	2	Thread は優先順位が AboveNormal のスレッドから BelowNormal のスレッドの間にスケジュールできます。 スレッドの既定の優先順位は Normal です。

例

次のコード例は、スレッドの優先度を変更した結果を示しています。 3 つのスレッドが作成され、1 つのスレッドの優先度が BelowNormal に設定され、2 番目のスレッドの優先度が AboveNormal に設定されます。 各スレッドは、ループ内の変数を while インクリメントし、設定された時間だけ実行します。

using System;
using System.Threading;
using Timers = System.Timers;

class Test
{
    static void Main()
    {
        PriorityTest priorityTest = new PriorityTest();

        Thread thread1 = new Thread(priorityTest.ThreadMethod);
        thread1.Name = "ThreadOne";
        Thread thread2 = new Thread(priorityTest.ThreadMethod);
        thread2.Name = "ThreadTwo";
        thread2.Priority = ThreadPriority.BelowNormal;
        Thread thread3 = new Thread(priorityTest.ThreadMethod);
        thread3.Name = "ThreadThree";
        thread3.Priority = ThreadPriority.AboveNormal;

        thread1.Start();
        thread2.Start();
        thread3.Start();
        // Allow counting for 10 seconds.
        Thread.Sleep(10000);
        priorityTest.LoopSwitch = false;
    }
}

class PriorityTest
{
    static volatile bool loopSwitch;
    [ThreadStatic] static long threadCount = 0;

    public PriorityTest()
    {
        loopSwitch = true;
    }

    public bool LoopSwitch
    {
        set{ loopSwitch = value; }
    }

    public void ThreadMethod()
    {
        while(loopSwitch)
        {
            threadCount++;
        }
        Console.WriteLine("{0,-11} with {1,11} priority " +
            "has a count = {2,13}", Thread.CurrentThread.Name, 
            Thread.CurrentThread.Priority.ToString(), 
            threadCount.ToString("N0")); 
    }
}
// The example displays output like the following:
//    ThreadOne   with      Normal priority has a count =   755,897,581
//    ThreadThree with AboveNormal priority has a count =   778,099,094
//    ThreadTwo   with BelowNormal priority has a count =     7,840,984

Imports System.Threading
Imports Timers = System.Timers

Public Module Example
   Dim t As Timers.Timer
   Private priorityTest As New PriorityTest()

    Public Sub Main()
        Dim thread1 As New Thread(AddressOf priorityTest.ThreadMethod)
        thread1.Name = "ThreadOne"
        Dim thread2 As New Thread(AddressOf priorityTest.ThreadMethod)
        thread2.Name = "ThreadTwo"
        thread2.Priority = ThreadPriority.BelowNormal
        Dim thread3 As New Thread(AddressOf priorityTest.ThreadMethod)
        thread3.Name = "ThreadThree"
        thread3.Priority = ThreadPriority.AboveNormal
        thread1.Start()
        thread2.Start()
        thread3.Start()

        ' Allow threads to execute for about 10 seconds.
        t = New Timers.Timer()
        t.AutoReset = False
        t.Interval = 10000
        AddHandler t.Elapsed, AddressOf Elapsed
        t.Start()
    End Sub

    Private Sub Elapsed(sender As Object, e As Timers.ElapsedEventArgs)
       priorityTest.LoopSwitch = False
    End Sub
End Module

Public Class PriorityTest
    Private Shared loopSwitchValue As Boolean
    <ThreadStatic> Shared threadCount As Long

    Sub New()
        loopSwitchValue = True
    End Sub

    WriteOnly Property LoopSwitch As Boolean
        Set
            loopSwitchValue = Value
        End Set
    End Property

    Sub ThreadMethod()
        Do While True
            threadCount += 1
            If Not loopSwitchValue Then Exit Do
        Loop

        Console.WriteLine("{0,-11} with {1,11} priority " &
            "has a count = {2,13}", Thread.CurrentThread.Name,
            Thread.CurrentThread.Priority.ToString(),
            threadCount.ToString("N0")) 
    End Sub
End Class
' The example displays the following output:
'    ThreadOne   with      Normal priority has a count =   755,897,581
'    ThreadThree with AboveNormal priority has a count =   778,099,094
'    ThreadTwo   with BelowNormal priority has a count =     7,840,984

注釈

ThreadPriority は、スレッド優先度に対して使用可能なすべての値のセットを定義します。 スレッドの優先度は、スレッド間の相対的な優先度を指定します。

すべてのスレッドに優先度が割り当てられます。 ランタイム内で作成されたスレッドには最初に優先度が割り当てられます Normal が、ランタイムの外部で作成されたスレッドは、ランタイムに入るときに以前の優先度を保持します。 スレッドのプロパティにアクセスすることで、スレッドの優先度を Priority 取得および設定できます。

スレッドの実行は、優先度に基づいてスケジュールされます。 スレッドの実行順序の決定に使用されるスケジューリング アルゴリズムは、オペレーティング システムによって異なります。 オペレーティング システムでは、ユーザー インターフェイスのフォーカスがフォアグラウンドと背景の間を移動するにつれて、スレッドの優先度を動的に調整することもできます。

スレッドの優先度は、スレッドの状態には影響しません。オペレーティング システムでスケジュールを設定するには、スレッドの状態が である Running 必要があります。

こちらもご覧ください

• Thread
• スレッドのスケジューリング