Thread.EndCriticalRegion メソッド

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

Thread.EndCriticalRegion メソッド

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

スレッドの中止または処理されない例外の影響が現在のタスクだけに及ぶコード領域に実行が入ることをホストに通知します。

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

Visual Basic (宣言)

Public Shared Sub EndCriticalRegion

Visual Basic (使用法)

Thread.EndCriticalRegion

C#

public static void EndCriticalRegion
 ()

C++

public:
static void EndCriticalRegion ()

J#

public static void EndCriticalRegion
 ()

JScript

public static function EndCriticalRegion
 ()

解説

メモ
このメソッドに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization または ExternalThreading です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

Microsoft® SQL Server "Yukon" などの共通言語ランタイム (CLR: Common Language Runtime) のホストは、重大なコード領域でのエラーと重大でないコード領域でのエラーに対して異なるポリシーを設定できます。重大な領域とは、スレッドの中止または処理されない例外の影響が現在のタスク以外にも及ぶ可能性がある領域です。これに対し、重大でないコード領域内での中止またはエラーは、エラーが発生したタスクだけに影響します。

たとえば、ロックを保持している間にメモリを割り当てるタスクがあると仮定します。メモリ割り当てが失敗した場合、AppDomain の安定性を確保するためには現在のタスクを中止するだけでは不十分です。これは、同じロックを待機している他のタスクがそのドメイン内に存在する可能性があるためです。現在のタスクが終了した場合に、他のタスクがデッドロック状態になる可能性があります。

重大な領域で障害が発生した場合、潜在的に不安定な状態で実行を継続する危険を冒すよりも AppDomain 全体をアンロードすることをホストが決定することがあります。コードが重大な領域に入ることをホストに通知するには、BeginCriticalRegion を呼び出します。重大でないコード領域に実行が戻るときには、EndCriticalRegion を呼び出します。

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

使用例

BeginCriticalRegion メソッドおよび EndCriticalRegion メソッドを使用してコード ブロックを重大な領域と重大でない領域に分割する例を次に示します。

Visual Basic

Imports System.Threading

Public Class MyUtility
    Public Sub PerformTask() 
        ' Code in this region can be aborted without affecting
        ' other tasks.
        '
        Thread.BeginCriticalRegion()
        '
        ' The host might decide to unload the application domain
        ' if a failure occurs in this code region.
        '
        Thread.EndCriticalRegion()
        ' Code in this region can be aborted without affecting
        ' other tasks.
    End Sub
End Class 

C#

using System.Threading;

public class MyUtility
{
    public void PerformTask()
    {
        // Code in this region can be aborted without affecting
        // other tasks.
        //
        Thread.BeginCriticalRegion();
        //
        // The host might decide to unload the application domain
        // if a failure occurs in this code region.
        //
        Thread.EndCriticalRegion();
        //
        // Code in this region can be aborted without affecting
        // other tasks.
    }
}

C++

using namespace System::Threading;

public ref class MyUtility
{
public:
   void PerformTask()
   {
      // Code in this region can be aborted without affecting
      // other tasks.
      //
      Thread::BeginCriticalRegion();
      //
      // The host might decide to unload the application domain
      // if a failure occurs in this code region.
      //
      Thread::EndCriticalRegion();
      //
      // Code in this region can be aborted without affecting
      // other tasks.
   }
};

J#

import System.Threading.*;
import System.Threading.Thread;

public class MyUtility
{
    public void PerformTask()
    {
        // Code in this region can be aborted without affecting
        // other tasks.
        //
        Thread.BeginCriticalRegion();

        //
        // The host might decide to unload the application domain
        // if a failure occurs in this code region.
        //
        Thread.EndCriticalRegion();
        // Code in this region can be aborted without affecting
        // other tasks.
    } //PerformTask
} //MyUtility

プラットフォーム

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 名前空間
BeginCriticalRegion