Partilhar via

Depurar 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 comece a depuração a partir do próprio projeto DLL. Para que esse método funcione, o aplicativo deve chamar a mesma DLL no mesmo local que você configura. 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 a sua aplicação gerida chamar uma DLL nativa, ou a sua aplicação nativa chamar uma DLL gerida, pode depurar a DLL e a aplicação que faz a chamada. Para obter mais informações, consulte Como depurar no modo misto.

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

Especificar um aplicativo de chamada em um projeto DLL nativo

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

  2. Na caixa de diálogo Páginas de Propriedades do <Projeto>, defina o campo Configuração na parte superior como Depurar.

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

  4. Expanda a lista Depurador para iniciar 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 chamador, como um arquivo .exe .

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

  6. Adicione quaisquer argumentos de programa necessários à caixa Argumentos de comando .

  7. Selecione OK.

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

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

  2. Na guia Depurar, selecione Abrir interface do usuário de perfis de inicialização de depuração.

  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 (arquivo.exe ) 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 do 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 DLL gerenciado (.NET Framework)

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto DLL C# ou 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 totalmente qualificado e o nome do aplicativo de chamada.

    • Em alternativa, selecione Iniciar navegador com URL e introduza o URL de uma aplicação ASP.NET local.

    • Para DLLs do .NET Core no Visual Basic, a página Propriedades de depuração é diferente. Expanda a lista suspensa Lançar, selecione Executável e, em seguida, adicione o caminho totalmente qualificado e o nome da aplicação que está a ser chamada no campo Executável.

  4. Adicione quaisquer 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 em C# no Visual Studio.

  5. Para salvar as alterações, selecione Arquivo>Salvar itens selecionados (Ctrl+S).

Depurar do projeto 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 verde Iniciar ou selecione Depurar>Iniciar Depuração.

Sugestão

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

  • Se pretender entrar no código em uma aplicação de chamadas gerida a partir 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