RuntimeHelpers.PrepareConstrainedRegions メソッドとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > RuntimeHelpers.PrepareConstrainedRegions メソッドの意味・解説 

RuntimeHelpers.PrepareConstrainedRegions メソッド

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

コード本体を制約された実行領域 (CER) として指定します。

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

Public Shared Sub PrepareConstrainedRegions
RuntimeHelpers.PrepareConstrainedRegions
public static void PrepareConstrainedRegions
 ()
public:
static void PrepareConstrainedRegions ()
public static void PrepareConstrainedRegions
 ()
public static function PrepareConstrainedRegions
 ()
解説解説

PrepareConstrainedRegions メソッドは、catch、finally、および fault ブロックを、制約された実行領域 (CER) としてマークします。制約された領域としてマークされたコードから他のコードを呼び出す場合、そのコードには、信頼性が十分高いコントラクトが必要となります。準備されていないメソッドや信頼性の低いメソッドについては、エラー処理に対する準備がなされていないと、メモリを割り当てたり、仮想呼び出しを実行したりすることはできません。

中間言語のオペコード (NOP を除く) を、PrepareConstrainedRegions メソッドの呼び出しと try ブロックの間に置くことはできません。CER の詳細については、System.Runtime.ConstrainedExecution 名前空間の各クラスのトピックを参照してください。

try ブロックから StackOverflowException が生成された場合、PrepareConstrainedRegions メソッドを使ってマークされた CER は完全には機能しません。詳細については、ExecuteCodeWithGuaranteedCleanup メソッドのトピックを参照してください。

PrepareConstrainedRegions メソッドは ProbeForSufficientStack メソッドを呼び出します。

使用例使用例

PrepareConstrainedRegions メソッドを使用して、ハンドルを確実に設定する方法を次のコード例に示します。ハンドルを指定した既存のハンドルに確実に設定するには、ネイティブ ハンドルの割り当てと SafeHandle オブジェクト内でのそのハンドルの以降の記録を必ず分離不可能な状態にすることが必要です。これらの操作間でエラーが発生すると (スレッドの中止やメモリ不足の例外によるエラーなど)、ネイティブ ハンドルがリークされることになります。PrepareConstrainedRegions メソッドを使用すると、ハンドルのリークを確実に防ぐことができます。

<StructLayout(LayoutKind.Sequential)> _
Structure MyStruct
    Public m_outputHandle As IntPtr
End Structure 'MyStruct


NotInheritable Class MySafeHandle
    Inherits SafeHandle

    ' Called by P/Invoke when returning SafeHandles
    Public Sub New()
        MyBase.New(IntPtr.Zero, True)

    End Sub


    Public Function AllocateHandle() As
 MySafeHandle
        ' Allocate SafeHandle first to avoid failure later.
        Dim sh As New MySafeHandle()

        RuntimeHelpers.PrepareConstrainedRegions()
        Try
        Finally
            Dim myStruct As New
 MyStruct()
            NativeAllocateHandle(myStruct)
            sh.SetHandle(myStruct.m_outputHandle)
        End Try

        Return sh

    End Function


[StructLayout(LayoutKind.Sequential)]
struct MyStruct
{
    public IntPtr m_outputHandle;
}

sealed class MySafeHandle : SafeHandle
{
    // Called by P/Invoke when returning SafeHandles
    public MySafeHandle()
        : base(IntPtr.Zero, true)
    {
    }

    public MySafeHandle AllocateHandle()
    {
        // Allocate SafeHandle first to avoid failure later.
        MySafeHandle sh = new MySafeHandle();

        RuntimeHelpers.PrepareConstrainedRegions();
        try { }
        finally
        {
            MyStruct myStruct = new MyStruct();
            NativeAllocateHandle(ref myStruct);
            sh.SetHandle(myStruct.m_outputHandle);
        }

        return sh;
    }

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
RuntimeHelpers クラス
RuntimeHelpers メンバ
System.Runtime.CompilerServices 名前空間



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「RuntimeHelpers.PrepareConstrainedRegions メソッド」の関連用語

RuntimeHelpers.PrepareConstrainedRegions メソッドのお隣キーワード

   

英語⇒日本語
日本語⇒英語
   



RuntimeHelpers.PrepareConstrainedRegions メソッドのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS