Depurar no modo misto (C#, C++, Visual Basic)

Este artigo descreve como habilitar a depuração para código gerenciado e nativo juntos, conhecido como depuração de modo misto. Há dois cenários de depuração de modo misto:

• O aplicativo que chama uma DLL é escrito em código nativo e a DLL é gerenciada.

• O aplicativo que chama uma DLL é escrito em código gerenciado e a DLL está em código nativo. Para obter um tutorial que explica esse cenário, confira Depurar código gerenciado e nativo.

Você pode habilitar depuradores gerenciados e nativos nas páginas Propriedade do projeto de aplicativo de chamada. As configurações são diferentes para aplicativos nativos e gerenciados.

Se você não tiver acesso ao projeto de um aplicativo de chamada, poderá depurar a DLL do projeto DLL. Você não precisa do modo misto para depurar. Você precisa apenas do projeto DLL. Para obter mais informações, confira Como depurar de um projeto de DLL.

Observação

Os diálogos e comandos descritos neste artigo podem diferir da sua experiência, dependendo das configurações ou edição do Visual Studio. Para alterar as configurações, escolha Ferramentas>Importar e Exportar Configurações. Para obter mais informações, confira Redefinir todas as configurações.

Habilitar o modo misto para um aplicativo de chamada nativo (C++)

Para habilitar a depuração de modo misto para um aplicativo de chamada nativo em C++, siga estas etapas:

1. No Gerenciador de Soluções do Visual Studio, clique com o botão direito do mouse no projeto C++ e escolha Propriedades ou use o atalho de teclado Alt + Enter. A caixa de diálogo <Páginas de Propriedades> do Projeto é aberta.

2. Na caixa de diálogo, expanda a seção Propriedades de configuração e escolha a guia Depuração .

3. Na guia Depuração, selecione a propriedade Tipo de Depurador e use a lista suspensa para escolher a opção Automático ou Misto. Se houver várias opções para Misto, como .NET Core e .NET Framework, escolha a melhor opção para sua configuração.

   

4. Para aplicar a alteração de propriedade, escolha OK.

Habilitar o modo misto para aplicativo de chamada gerenciado (C# ou Visual Basic)

Para habilitar a depuração de modo misto para um aplicativo de chamada gerenciado em C# ou Visual Basic, siga estas etapas:

1. No Gerenciador de Soluções do Visual Studio, clique com o botão direito do mouse no projeto C# ou Visual Basic e escolha Propriedades, ou use o atalho de teclado Alt + Enter. O painel Propriedades é aberto.

2. No painel Propriedades, habilite a depuração de modo misto definindo a seguinte propriedade:

   Código .NET

   1. No menu esquerdo, escolha Depuração.

   2. Na seção Geral, selecione o link Abrir perfis de inicialização de depuração da interface do usuário. A caixa de diálogo Iniciar perfis é aberta.

   3. Na caixa de diálogo, role para localizar a seção Habilitar depuração de código nativo.

   4. Escolha a propriedade Habilitar depuração para código gerenciado e nativo juntos, também conhecida como depuração de modo misto:

      

   5. Para aplicar a alteração de propriedade, feche a caixa de diálogo Iniciar Perfis e o painel Propriedades.

   Código do .NET Framework

   Se você estiver usando o código do .NET Framework, que não tem perfil de inicialização de depuração, siga estas etapas:

   1. No menu esquerdo, escolha Depuração.

   2. Na seção Mecanismos do depurador, escolha a propriedade Habilitar depuração de código nativo:

      

   3. Para aplicar a alteração de propriedade, feche o painel Propriedades.

Conteúdo relacionado

• Depurar por meio de um projeto DLL
• Depurar códigos nativos e gerenciados
• Redefinir todas as configurações