RuntimeHelpers.PrepareConstrainedRegions Méthode

Définition

Espace de noms:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Attention

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

Désigne une partie de code comme région d'exécution limitée.

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

public static void PrepareConstrainedRegions ();

[System.Security.SecurityCritical]
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

static member PrepareConstrainedRegions : unit -> unit

[<System.Security.SecurityCritical>]
static member PrepareConstrainedRegions : unit -> unit

Public Shared Sub PrepareConstrainedRegions ()

Attributs

ObsoleteAttribute SecurityCriticalAttribute

Exemples

L’exemple suivant montre comment définir de manière fiable des handles à l’aide de la PrepareConstrainedRegions méthode. Pour définir de manière fiable un handle sur un handle préexistant spécifié, vous devez vous assurer que l’allocation du handle natif et l’enregistrement ultérieur de ce handle dans un SafeHandle objet sont atomiques. Tout échec entre ces opérations (par exemple, une exception d’abandon de thread ou une exception de mémoire insuffisante) entraîne la fuite du handle natif. Vous pouvez utiliser la PrepareConstrainedRegions méthode pour vous assurer que le handle n’est pas divulgué.

[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

Remarques

Les compilateurs utilisent cette méthode pour marquer catch des finally blocs, et fault en tant que régions d’exécution restreinte (CER). Le code qui est marqué comme une région avec restriction doit uniquement appeler un autre code avec des contrats de fiabilité forts. Il ne doit pas allouer ou effectuer des appels virtuels à des méthodes non préparées ou non fiables, sauf s’il est prêt à gérer les défaillances.

Notez qu’aucun opcode de langage intermédiaire, sauf NOP , n’est autorisé entre un appel à la PrepareConstrainedRegions méthode et le try bloc. Pour plus d’informations sur les zones CER, consultez les classes de l' System.Runtime.ConstrainedExecution espace de noms.

Les CER qui sont marquées à l’aide de la PrepareConstrainedRegions méthode ne fonctionnent pas parfaitement quand un StackOverflowException est généré à partir du try bloc. Pour plus d'informations, voir la méthode ExecuteCodeWithGuaranteedCleanup.

La méthode PrepareConstrainedRegions appelle la méthode ProbeForSufficientStack.