Assistant Débogage managé illegalPrepareConstrainedRegion

Article
04/07/2023

L’Assistant Débogage managé illegalPrepareConstrainedRegion est activé quand un appel de méthode RuntimeHelpers.PrepareConstrainedRegions ne précède pas immédiatement l’instruction try du gestionnaire d’exceptions. Cette restriction étant au niveau MSIL, il est permis d’avoir une source générant du non-code entre l’appel et try, telle que les commentaires.

Symptômes

Une région d’exécution limitée n’est jamais traitée comme telle, mais comme un bloc de gestion des exceptions simple (finally ou catch). Par conséquent, la région ne s’exécute pas en cas de mémoire insuffisante ou d’interruption de thread.

Cause

Le modèle de préparation pour une région d’exécution limitée n’est pas suivi correctement. Il s’agit d’un événement d’erreur. L’appel de méthode PrepareConstrainedRegions utilisé pour marquer des gestionnaires d’exceptions comme introduisant une région d’exécution limitée dans leurs blocs catch/finally/fault/filter doit être utilisé immédiatement avant l’instruction try.

Résolution

Vérifiez que l’appel à PrepareConstrainedRegions se produit immédiatement avant l’instruction try.

Effet sur le runtime

Cet Assistant Débogage managé n'a aucun effet sur le CLR.

Sortie

L’Assistant Débogage managé affiche le nom de la méthode qui appelle la méthode PrepareConstrainedRegions, l’offset MSIL et un message indiquant que l’appel ne précède pas immédiatement le début du bloc try.

Configuration

<mdaConfig>  
  <assistants>  
    <illegalPrepareConstrainedRegion/>  
  </assistants>  
</mdaConfig>

Exemple

L’exemple de code suivant illustre le modèle qui provoque l’activation de cet Assistant Débogage managé.

void MethodWithInvalidPCR()  
{  
    RuntimeHelpers.PrepareConstrainedRegions();  
    Object o = new Object();  
    try  
    {  
        …  
    }  
    finally  
    {  
        …  
    }  
}

Partager via