Thread.BeginThreadAffinity メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Thread.BeginThreadAffinity メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

マネージコードが現在のオペレーティングシステムの物理スレッドの ID に依存する命令の実行を開始することをホストに通知します。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub BeginThreadAffinity

Visual Basic (使用法)

Thread.BeginThreadAffinity

public static void BeginThreadAffinity
 ()

C++

public:
static void BeginThreadAffinity ()

public static void BeginThreadAffinity
 ()

JScript

public static function BeginThreadAffinity
 ()

例外

例外の種類	条件
SecurityException	呼び出し元に、必要なアクセス許可がありません。

解説

共通言語ランタイムの一部のホスト (たとえば Microsoft® SQL Server "Yukon") では、独自のスレッド管理機能が用意されています。独自のスレッド管理機能を持つホストは、いつでも実行タスクをオペレーティングシステムの物理スレッド間で移動できます。ほとんどのタスクはこの切り替えの影響を受けません。ただし、一部のタスクにはスレッドアフィニティがあります。つまり、これらのタスクは、オペレーティングシステムの物理スレッドの ID に依存します。これらのタスクは、切り替えてはいけないコードを実行するときにホストに通知する必要があります。

たとえば、Win32 CRITICAL_SECTION のようなスレッドアフィニティを持つオペレーティングシステムのロックを取得するシステム API をアプリケーションで呼び出す場合、このロックを取得する前に BeginThreadAffinity を呼び出し、ロックを解放した後に EndThreadAffinity を呼び出す必要があります。

また、WaitHandle から継承する .NET Framework の型はオペレーティングシステムオブジェクトに依存するため、これらの型をブロックする前に BeginThreadAffinity を呼び出す必要があります。

SQL Server "Yukon" で実行するコード内でこのメソッドを使用するには、ホストの保護レベルを最大にしてコードを実行する必要があります。

使用例

BeginThreadAffinity メソッドおよび EndThreadAffinity メソッドを使用してコードブロックがオペレーティングシステムの物理スレッドの ID に依存することをホストに通知する例を次に示します。

Visual Basic

Imports System.Threading
Imports System.Security.Permissions

<SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlThread)>
 _
Friend Class MyUtility
    <SecurityPermission(SecurityAction.Demand, Flags:=SecurityPermissionFlag.ControlThread)>
 _
    Public Sub PerformTask() 
        ' Code that does not have thread affinity goes here.
        '
        Thread.BeginThreadAffinity()
        '
        ' Code that has thread affinity goes here.
        '
        Thread.EndThreadAffinity()
        '
        ' More code that does not have thread affinity.
    End Sub 'PerformTask
End Class 'MyUtility

using System.Threading;
using System.Security.Permissions;

[SecurityPermission(SecurityAction.Demand, Flags=SecurityPermissionFlag.ControlThread)]
public class MyUtility
{
    [SecurityPermission(SecurityAction.Demand, Flags=SecurityPermissionFlag.ControlThread)]
    public void PerformTask()
    {
        // Code that does not have thread affinity goes here.
        //
        Thread.BeginThreadAffinity();
        //
        // Code that has thread affinity goes here.
        //
        Thread.EndThreadAffinity();
        //
        // More code that does not have thread affinity.
    }
}

C++

using namespace System::Threading;
using namespace System::Security::Permissions;

public ref class MyUtility
{
public:
   [SecurityPermissionAttribute(SecurityAction::Demand, ControlThread=true)]
   void PerformTask()
   {
      // Code that does not have thread affinity goes here.
      //
      Thread::BeginThreadAffinity();
      //
      // Code that has thread affinity goes here.
      //
      Thread::EndThreadAffinity();
      //
      // More code that does not have thread affinity.
   }
};