RuntimeHelpers.PrepareConstrainedRegions Método

Definição

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Origem:

RuntimeHelpers.cs

Cuidado

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

Designa um corpo de código como uma região de execução restrita (CER).

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 ()

Atributos

ObsoleteAttribute

Exemplos

O exemplo a seguir mostra como definir identificadores de forma confiável usando o PrepareConstrainedRegions método . Para definir de forma confiável um identificador para um identificador pré-existente especificado, você deve garantir que a alocação do identificador nativo e a gravação subsequente desse identificador em um SafeHandle objeto sejam atômicas. Qualquer falha entre essas operações (como uma anulação de thread ou exceção de memória insuficiente) resultará na perda do identificador nativo. Você pode usar o PrepareConstrainedRegions método para garantir que o identificador não seja vazado.

[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

Comentários

Os compiladores usam esse método para marcar catchos blocos , finallye fault como CERs (regiões de execução restritas). O código marcado como uma região restrita só deve chamar outro código com contratos de confiabilidade fortes. Ele não deve alocar nem fazer chamadas virtuais para métodos não preparados ou não confiáveis, a menos que esteja preparado para lidar com falhas.

Observe que nenhum opcode de linguagem intermediária, exceto NOP, é permitido entre uma chamada para o PrepareConstrainedRegions método e o try bloco. Para obter mais informações sobre CERs, consulte as classes no System.Runtime.ConstrainedExecution namespace .

Os CERs marcados usando o PrepareConstrainedRegions método não funcionam perfeitamente quando um StackOverflowException é gerado do try bloco. Para obter mais informações, consulte o método ExecuteCodeWithGuaranteedCleanup.

O método PrepareConstrainedRegions chama o método ProbeForSufficientStack.