Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O common linguagem tempo de execução (CLR) API de depuração permite que fornecedores de ferramentas escrever depuradores para depurar aplicativos executados no ambiente CLR. O código a ser depurado pode ser qualquer tipo de código que suporta o CLR.
API de depuração CLR é implementado principalmente com código não gerenciado. Portanto, a API de depuração é apresentada sistema autônomo um conjunto de interfaces COM. A API consiste em uma coleção de objetos COM e interfaces que são implementadas pelo CLR e uma coleção de interfaces de retorno de chamada COM que deve ser implementada pelo depurador. Como depurar essas interfaces são todos baseados em COM, programas de depurador podem ser com com facilidade estendidos para ativar a depuração remota usando COM distribuído (DCOM).
Categorias de API
A API de depuração inclui três grupos de interfaces, todos normalmente usado por um depurador CLR e todas implementadas sistema autônomo código não gerenciado a seguir:
Interfaces que oferecem suporte a depuração de aplicativos do CLR.
Interfaces que fornecem acesso a simbólico informações, que são normalmente armazenadas em arquivos de banco de dados (PDB) do programa de depurar.
Interfaces que oferecem suporte a consultas de processos e domínios de aplicativo em um computador.
A API de depuração depende de dois conjuntos adicionais de interfaces:
API de metadados para lidar com inspeção de informações sobre o programa estático sistema autônomo classes e sistema autônomo informações de método de tipo.
API de armazenamento para oferecer suporte à depuração de nível de código-fonte para código gerenciado depuradores de símbolo.
As interfaces de depuração também podem ser organizadas em categorias funcionais mostradas na tabela a seguir.
Categoria de API |
Descrição |
|---|---|
inscrição |
Interfaces que o depurador chama para registrar com o CLR e solicitar uma notificação quando eventos específicos ocorrem. |
Notificação |
Interfaces de retorno de chamada que o CLR usa para notificar o depurador de vários eventos e para retornar informações solicitadas. Essas interfaces devem ser implementadas pelo depurador. |
Ponto de interrupção |
Interfaces que o depurador chama para recuperar informações sobre pontos de interrupção. |
Execução |
Interfaces que o depurador telefonar s para controlar a execução do ser depurado e o acesso telefonar pilhas. |
Informações |
Interfaces que o depurador chama para obter informações sobre o elemento a ser depurado. |
Enumeração |
Interfaces que o depurador chama para enumerar objetos. |
Modification |
Interfaces que o depurador chama para modificar o código que está sendo depurado. |
Ambientes compatíveis
Recursos de depuração CLR estão disponível em todos os processadores e sistemas operacionais que suporta o CLR, com as seguintes exceções:
Não há suporte para edição e continuação e depuração de modo misto em sistemas operacionais de 64 bit. The SetIP () métodosICorDebugILFrame::SetIP and ICorDebugNativeFrame::SetIP) ter restrições adicionais em sistemas operacionais de 64 bit. A funcionalidade restante é equivalente em todos os processadores, permitindo a representações de dados específicos do processador (tamanhos de ponteiro, contextos de registro e assim por diante).
Não há suporte para edição e continuação e depuração de modo misto em sistemas operacionais baseados no Win9x. Com algumas exceções específicas, são observadas na documentação das funções individuais, a funcionalidade restante deve ser equivalente em todos os sistemas operacionais.