Compartilhar via


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

Este artigo descreve como habilitar a depuração para código gerenciado e código 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, consulte Como depurar de um projeto de DLL.

Nota

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

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

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

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

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

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

    Captura de tela que mostra como habilitar a depuração de modo misto para um projeto C++ no Visual Studio.

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

Habilitar o modo misto para o aplicativo de chamada gerenciada (.NET)

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

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

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

    Código .NET

    1. No menu à esquerda, selecione Depurar.

    2. Na seção Geral, selecione o link Abrir perfis de inicialização de depuração. A caixa de diálogo Perfis de inicialização é aberta.

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

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

      Captura de tela que mostra como habilitar a depuração de modo misto para um projeto C# ou Visual Basic no Visual Studio.

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

Habilitar o modo misto para o aplicativo de chamada gerenciada (.NET Framework)

Para habilitar a depuração de modo misto para um aplicativo que utiliza o .NET Framework em C# ou Visual Basic, siga estas etapas:

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

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

    1. No menu à esquerda, selecione Depurar.

    2. Na seção Mecanismos do depurador, selecione a opção Habilitar a depuração do código nativo:

      Captura de tela que mostra como habilitar a depuração de modo misto para um projeto C# ou Visual Basic no Visual Studio 2019.

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

    ::: moniker-end