RuntimeHelpers.PrepareConstrainedRegions Yöntem

Tanım

Ad Alanı:

System.Runtime.CompilerServices

Bütünleştirilmiş Kodlar:

netstandard.dll, 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 ayırmasının ve bu tanıtıcının nesne SafeHandle 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, , catchve finally bloklarını kısıtlanmış yürütme bölgeleri (CER) olarak işaretlemek faultiç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ırlıksız veya güvenilir olmayan yöntemlere sanal çağrılar ayırmamalı veya yapmamalıdır.

yöntemine yapılan çağrı ile blok arasında, dışında NOPara dil opcode'larına PrepareConstrainedRegions izin verilmediğini try 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şaretlenen CER'ler, bloktan StackOverflowException bir try oluşturulduğunda mükemmel çalışmaz. Daha fazla bilgi için bkz. ExecuteCodeWithGuaranteedCleanup yöntemi.

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