Compartilhar via

Depuração de um projeto DLL no Visual Studio (C#, C++, Visual Basic, F#)

Uma maneira de depurar um projeto DLL é especificar o aplicativo de chamada nas propriedades do projeto DLL. Essa abordagem permite que você inicie a depuração do próprio projeto de DLL. Para que esse método funcione, o aplicativo deve chamar a mesma DLL no mesmo local configurado. Se o aplicativo encontrar e carregar uma versão diferente da DLL, essa versão não conterá seus pontos de interrupção. Para outros métodos de depuração de DLLs, consulte Depurando projetos DLL.

Se o aplicativo gerenciado chamar uma DLL nativa ou o aplicativo nativo chamar uma DLL gerenciada, você poderá depurar a DLL e o aplicativo de chamada. Para obter mais informações, consulte Como depurar no modo misto.

Projetos de DLL nativos e gerenciados têm configurações diferentes para especificar aplicativos de chamada.

Especificar um aplicativo de chamada em um projeto de DLL nativo

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto de DLL do C++ e selecione Propriedades (Alt+Enter).

  2. No diálogo <Páginas de Propriedade de> Projeto, defina o campo Configuração na parte superior como Depurar.

  3. Selecione Propriedades de Configuração>Depuração.

  4. Expanda o Depurador para iniciar a lista e selecione Depurador local do Windows ou Depurador remoto do Windows.

  5. Na caixa Comando ou Comando Remoto , adicione o caminho totalmente qualificado e o nome do arquivo do aplicativo de chamada, como um arquivo .exe .

    Captura de tela da janela Propriedades de Depuração no Visual Studio mostrando o valor do comando.

  6. Adicione todos os argumentos de programa necessários à caixa Argumentos de Comando .

  7. Selecione OK.

Especificar um aplicativo de chamada em um projeto de DLL gerenciado (.NET Core, .NET 5+)

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto DLL do C# ou do Visual Basic e selecione Propriedades (Alt+Enter).

  2. Na guia Depurar, selecione Abrir depuração dos perfis de inicialização da IU.

  3. Na caixa de diálogo Iniciar Perfis , selecione o ícone Criar um novo perfil e selecione Executável.

    Captura de tela da interface do usuário para criar um novo perfil de depuração no Visual Studio 2022.

  4. No novo perfil, em Executável, navegue até o local do executável (.exe arquivo) e selecione-o.

  5. Na caixa de diálogo Iniciar Perfis , anote o nome do perfil padrão e, em seguida, selecione o perfil e exclua-o.

  6. Renomeie o novo perfil para o mesmo nome que o perfil padrão.

    Uma abordagem alternativa é editar manualmente o arquivo launchSettings.json . Você deseja que o primeiro perfil no arquivo launchSettings.json corresponda ao nome da Biblioteca de Classes e deseja que o perfil seja listado primeiro no arquivo.

Especificar um aplicativo de chamada em um projeto de DLL gerenciado (.NET Framework)

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto DLL do C# ou do Visual Basic e selecione Propriedades (Alt+Enter).

  2. Defina o campo Configuração na parte superior como Depurar.

  3. Em Iniciar Ação:

    • Para DLLs do .NET Framework, selecione Iniciar programa externo e adicione o caminho e o nome totalmente qualificados do aplicativo de chamada.

    • Ou selecione Iniciar navegador com URL e insira a URL de um aplicativo de ASP.NET local.

    • Para DLLs do .NET Core no Visual Basic, a página Propriedades de Depuração é diferente. Expanda a lista suspensa Iniciar e selecione Executável e adicione o caminho totalmente qualificado e o nome do aplicativo de chamada ao campo Executável.

  4. Adicione todos os argumentos de linha de comando necessários no campo Argumentos de linha de comando ou Argumentos de aplicativo.

    Captura de tela da janela Propriedades de Depuração do C# no Visual Studio.

  5. Para salvar suas alterações, selecione Salvar Arquivos>Itens Selecionados (Ctrl+S).

Depurar do projeto de DLL

  1. Defina pontos de interrupção no projeto DLL.

  2. Clique com o botão direito do mouse no projeto DLL e selecione Definir como Projeto de Inicialização.

  3. Defina o campo Configuração de Soluções na parte superior como Depurar. Selecione F5 e, em seguida, selecione a seta inicial verde ou selecione Depurar>Iniciar Depuração.

Dica

  • Se a depuração não atingir os pontos de interrupção, verifique se a saída da DLL (por padrão, a pasta <project>\Debug) é o local da chamada de destino para o aplicativo de chamada.

  • Para acessar o código em um aplicativo de chamada gerenciado de uma DLL nativa ou vice-versa, habilite a depuração de modo misto.

  • Em alguns cenários, talvez seja necessário instruir o depurador onde encontrar o código-fonte. Para obter mais informações, consulte Usar as páginas Sem Símbolos Carregados/Sem Fonte Carregada.

Conteúdo relacionado

  • Last updated on