Partilhar via

ilegalPrepareConstrainedRegion MDA

Nota

Este artigo é específico do .NET Framework. Ele não se aplica a implementações mais recentes do .NET, incluindo o .NET 6 e versões posteriores.

O illegalPrepareConstrainedRegion assistente de depuração gerenciado (MDA) é ativado quando uma RuntimeHelpers.PrepareConstrainedRegions chamada de método não precede imediatamente a try instrução do manipulador de exceções. Essa restrição está no nível MSIL, portanto, é permitido ter uma fonte não geradora de código entre a chamada e o try, como comentários.

Sintomas

Uma região de execução restrita (CER) que nunca é tratada como tal, mas como um simples bloco de manipulação de exceção (finally ou catch). Como consequência, a região não é executada no caso de uma condição de falta de memória ou um thread abortar.

Motivo

O padrão de preparação para uma RCE não é seguido corretamente. Este é um evento de erro. A PrepareConstrainedRegions chamada de método usada para marcar manipuladores de exceção como introduzindo um CER em seus//catchfault/finallyfilter blocos deve ser usada imediatamente antes da try instrução.

Resolução

Certifique-se de que a chamada para PrepareConstrainedRegions acontece imediatamente antes da try declaração.

Efeito no tempo de execução

Este MDA não tem efeito sobre o CLR.

Saída

O MDA exibe o nome do método que chama o PrepareConstrainedRegions método, o deslocamento MSIL e uma mensagem indicando que a chamada não precede imediatamente o início do bloco try.

Configuração

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

Exemplo

O exemplo de código a seguir demonstra o padrão que faz com que esse MDA seja ativado.

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

Consulte também

  • Last updated on