Thread.BeginThreadAffinity メソッド

.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

C#

public static void BeginThreadAffinity
 ()

C++

public:
static void BeginThreadAffinity ()

J#

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 

C#

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.
   }
};

.NET Framework のセキュリティ

• SecurityPermissionAttribute  (スレッド上で高度な操作を行うために必要なアクセス許可)。SecurityPermissionFlag.ControlThread (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Thread クラス
Thread メンバ
System.Threading 名前空間
EndThreadAffinity