RuntimeHelpers.PrepareConstrainedRegions Méthode

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.Security.SecurityCritical]
public static void PrepareConstrainedRegions ();

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

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

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. Toute défaillance entre ces opérations (par exemple, un 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 ne fuit pas.

[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 catchles blocs , finallyet fault en tant que régions d’exécution contraintes (CER). Le code marqué comme une région contrainte doit uniquement appeler un autre code avec des contrats de fiabilité forts. Il ne doit pas allouer ou effectuer d’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, à l’exception NOPde , n’est autorisé entre un appel à la PrepareConstrainedRegions méthode et le try bloc. Pour plus d’informations sur les cer, consultez les classes dans l’espace de System.Runtime.ConstrainedExecution noms.

Les CER marqués à 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.

S’applique à