Configurações do projeto para configurações de depuração em C# (.NET Core, .NET 5+ e ASP.NET Core)
Você pode alterar as configurações de depuração do projeto C# na guia Depuração e na guia Compilar das páginas de propriedades do projeto.
Para abrir as páginas de propriedades, selecione o projeto no Gerenciador de Soluções
Para obter mais informações, consulte Configurações de depuração e lançamento.
Importante
Essas configurações não se aplicam ao .NET Framework ou aplicativos UWP. Para configurar as configurações de depuração para o .NET Framework, consulte Configurações do projeto para configurações de depuração em C#.
Guia Depurar
A partir do Visual Studio 2022, escolha interface do usuário Abrir perfis de inicialização de depuração na guia Depurar para abrir a interface do usuário de perfis de inicialização e alterar as configurações de depuração.
Perfil de inicialização (.NET Core, .NET 5+)
| Configuração | Descrição |
|---|---|
| Argumentos de linha de comando | Especifica argumentos de linha de comando para a aplicação que está a ser depurada. O nome do comando é o nome da aplicação especificado em Iniciar programa externo. |
| Diretório de trabalho | Especifica o diretório de trabalho do aplicativo que está sendo depurado. Em C#, o diretório de trabalho é \bin\debug por padrão. |
| Usar máquina remota | Para depuração remota, selecione essa opção e insira o nome do destino de depuração remota ou um nome de servidor Msvsmon . O local de uma aplicação na máquina remota é especificado pela propriedade Caminho de Saída no separador Build. O local deve ser um diretório partilhável na máquina remota. |
| Variáveis de ambiente | Define variáveis de ambiente antes de executar o processo de aplicativo. Para ASP.NET Core, consulte Environments. |
| Habilitar a depuração de código não gerenciado | Depura chamadas para código Win32 nativo (não gerenciado) do aplicativo gerenciado. |
| Habilitar a depuração no SQL Server | Depura objetos de banco de dados do SQL Server. |
| Habilitar a depuração WebView2 | Depura JavaScript com o depurador baseado no Microsoft Edge (Chromium). |
Perfil de lançamento (ASP.NET Core)
Além das propriedades do .NET 5+, os perfis de inicialização do ASP.NET Core incluem várias propriedades adicionais para os diferentes perfis do ASP.NET Core. Essas configurações fornecem uma interface do usuário simples para o arquivo launchSettings.json do projeto. Para obter mais informações sobre esse arquivo, consulte a seção Desenvolvimento e launchSettings.json em Usar vários ambientes no ASP.NET Core.
As configurações fornecidas na interface do usuário de perfis de inicialização incluem o seguinte.
| Cenário | Descrição |
|---|---|
| Inicie o navegador | Selecione se deseja iniciar o navegador padrão ao começar a depuração, utilizando a URL que definiu na configuração URL. |
| URL | Especifica o local da URL do host para .NET ou .NET Core. Para um perfil nomeado após o projeto (ou seja, a propriedade commandName em launchSettings.json é Project), o servidor Kestrel escuta a porta especificada. Para um perfil do IIS, esse é normalmente o mesmo valor que a URL do aplicativo . Para obter mais informações, consulte a seção Perfil de inicialização do IIS em Configurar o projeto. |
| URL do aplicativo | Especifica a(s) URL(s) do aplicativo. Para um perfil com o nome do projeto, essa propriedade especifica as URLs do servidor Kestrel, normalmente https://localhost:5001 e http://localhost:5000. |
O Visual Studio fornece um perfil do IIS Express por padrão, e você pode criar perfis adicionais, como um perfil do IIS. Essas configurações também correspondem às configurações em launchSettings.json. Esses dois tipos de perfil fornecem várias configurações, como o modelo de hospedagem.
| Configuração | Descrição |
|---|---|
| Modelo de alojamento | Especifique Em Processo (padrão) ou Fora do Processo. Para obter mais informações, consulte Modelos de hospedagem nos documentos do ASP.NET Core. |
| URL SSL do aplicativo | Para o IIS Express, o de URL SSL do Aplicativo |
Aba Construir
A tabela a seguir mostra as configurações de compilação que são úteis para depuração. Para obter uma explicação completa das configurações de compilação, consulte Página de Compilação, no Project Designer.
| Cenário | Descrição |
|---|---|
| Símbolos de compilação condicional gerais> | Defina as constantes DEBUG e TRACE se selecionadas. Essas constantes ativam a compilação condicional da classe Debug e da classe Trace . Com essas constantes definidas, os métodos de classe Debug e Trace geram saída para a janela Output. Sem essas constantes, os métodos de classe Debug e Trace não são compilados e nenhuma saída é gerada. Normalmente, DEBUG é definido na versão de Debug de uma compilação e indefinido na versão de Release. TRACE é definido nas versões Debug e Release. |
| Geral>Otimizar código | A menos que um bug apareça apenas no código otimizado, deixe essa configuração desmarcada para compilações de depuração. O código otimizado é mais difícil de depurar, porque as instruções não correspondem diretamente às instruções no código-fonte. |
| Símbolos de depuração | Especifica o tipo de informações de depuração geradas pelo compilador. Consulte Símbolos de depuração. Para obter informações sobre como configurar o desempenho de depuração de um aplicativo, consulte Tornando uma imagem mais fácil de depurar. |
| Saída>caminho de saída base | Especifica a pasta base para saída intermediária. A saída normalmente vai para bin\Debug para uma compilação Debug. |
| Saída>Caminho de saída intermediário de base | Especifica a pasta base para saída intermediária. A saída normalmente vai para obj\Debug para uma compilação de Debug. |
Símbolos de depuração
Você pode escolher as seguintes opções para símbolos de depuração.
Nenhum símbolo é emitido
Especifica que nenhuma informação de depuração será gerada.
arquivo PDB, plataforma atual
Produz um arquivo . PDB, um arquivo de símbolo específico da plataforma que fornece outras ferramentas, especialmente depuradores, informações sobre o que está no arquivo executável principal e como ele foi produzido.
arquivo PDB, portátil
Produz um arquivo . PDB, um arquivo de símbolo portátil não específico da plataforma que fornece outras ferramentas, especialmente depuradores, informações sobre o que está no arquivo executável principal e como ele foi produzido. Consulte PDB portátil para obter mais informações.
Incorporado em DLL/EXE, portátil entre plataformas
Incorpora informações de símbolos portáteis no conjunto. Nenhum arquivo .PDB externo é produzido.
Para obter mais informações, consulte /debug (C# Compiler Options).