RuntimeHelpers.PrepareConstrainedRegions Yöntem

Tanım

Ad Alanı:

System.Runtime.CompilerServices

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

RuntimeHelpers.cs

Dikkat

The Constrained Execution Region (CER) feature is not supported.

Bir kod gövdesini kısıtlanmış yürütme bölgesi (CER) olarak tanımlar.

public:
 static void PrepareConstrainedRegions();

[System.Obsolete("The Constrained Execution Region (CER) feature is not supported.", DiagnosticId="SYSLIB0004", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static void PrepareConstrainedRegions ();

[<System.Obsolete("The Constrained Execution Region (CER) feature is not supported.", DiagnosticId="SYSLIB0004", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member PrepareConstrainedRegions : unit -> unit

Public Shared Sub PrepareConstrainedRegions ()

Öznitelikler

ObsoleteAttribute

Örnekler

Aşağıdaki örnekte yöntemini kullanarak tanıtıcıların güvenilir bir şekilde nasıl ayarlanacağı gösterilmektedir PrepareConstrainedRegions . Bir tanıtıcıyı önceden var olan belirli bir tanıtıcıya güvenilir bir şekilde ayarlamak için, yerel tanıtıcının ayrılmasını ve bu tanıtıcının bir SafeHandle nesne içindeki sonraki kaydının atomik olduğundan emin olmanız gerekir. Bu işlemler arasındaki herhangi bir hata (iş parçacığı durdurma veya bellek dışı özel durum gibi) yerel tanıtıcının sızdırılmasına neden olur. Tutamacın PrepareConstrainedRegions sızdırılmadığından emin olmak için yöntemini kullanabilirsiniz.

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

<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

Açıklamalar

Derleyiciler, , finallyve fault bloklarını kısıtlanmış yürütme bölgeleri (CER) olarak işaretlemek catchiçin bu yöntemi kullanır. Kısıtlanmış bölge olarak işaretlenen kodun yalnızca güçlü güvenilirlik sözleşmelerine sahip diğer kodları çağırması gerekir. Hataları işlemeye hazır olmadığı sürece hazır olmayan veya güvenilir olmayan yöntemlere sanal çağrılar ayırmamalı veya yapmamalıdır.

yöntemine yapılan çağrı ile try blok arasında dışında NOPara dil opcode'larına PrepareConstrainedRegions izin verilmediğini unutmayın. CER'ler hakkında daha fazla bilgi için ad alanında sınıflara System.Runtime.ConstrainedExecution bakın.

yöntemi kullanılarak PrepareConstrainedRegions işaretlenmiş CER'ler bloktan try bir StackOverflowException oluşturulduğunda mükemmel çalışmaz. Daha fazla bilgi için yöntemine ExecuteCodeWithGuaranteedCleanup bakın.

PrepareConstrainedRegions yöntemi yöntemini çağırırProbeForSufficientStack.