RuntimeHelpers.PrepareConstrainedRegions Méthode

Définition

Espace de noms:

System.Runtime.CompilerServices

Assembly:

mscorlib.dll

Désigne un corps de code en tant que région d’exécution contrainte (CER).

public:
 static void PrepareConstrainedRegions();

[System.Security.SecurityCritical]
public static void PrepareConstrainedRegions();

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

Public Shared Sub PrepareConstrainedRegions ()

Attributs

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 suivant de ce handle au sein d’un SafeHandle objet est atomique. Toute défaillance entre ces opérations (par exemple, une exception d’abandon de thread ou de mémoire insuffisante) entraîne la fuite du handle natif. Vous pouvez utiliser la PrepareConstrainedRegions méthode pour vous assurer que la poignée n’est pas divulguée.

[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, finallyet fault bloquer en tant que régions d’exécution contraintes (CER). Le code marqué comme une région contrainte ne doit appeler qu’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 CER, consultez les classes de l’espace System.Runtime.ConstrainedExecution de noms.

Les CER marqués à l’aide de la PrepareConstrainedRegions méthode ne fonctionnent pas parfaitement lorsqu’un StackOverflowException élément est généré à partir du try bloc. Pour plus d’informations, consultez la ExecuteCodeWithGuaranteedCleanup méthode.

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