Configurações de projeto para configurações de depuração do C# (.NET Core, .NET 5+ e ASP.NET Core)
É possível alterar as configurações de depuração de projeto em C# na guia Depurar 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 e, em seguida, selecione o ícone Propriedades ou clique com o botão direito do mouse no projeto e selecione Propriedades.
Para obter mais informações, confira Configurações de depuração e lançamento.
Importante
Essas configurações não se aplicam a aplicativos .NET Framework ou UWP. Para definir as configurações de depuração para .NET Framework, consulte Configurações do projeto para configurações de depuração do C#.
Guia de depuração
A partir do Visual Studio 2022, selecione Abrir a interface do usuário dos perfis de inicialização de depuração na guia Depurar para abrir a interface do usuário dos 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 o programa a ser depurado. O nome do comando é o nome do aplicativo 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 computador remoto | 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 um aplicativo no computador remoto é especificado pela propriedade Caminho de Saída na guia Compilar. O local deve ser um diretório que pode ser compartilhado no computador remoto. |
| Variáveis de ambiente | Define variáveis de ambiente antes de executar o processo do aplicativo. Para ASP.NET Core, consulte Ambientes. |
| Habilitar depuração de código não gerenciado | Depura chamadas para código Win32 nativo (não gerenciado) do aplicativo gerenciado. |
| Habilitar depuração do SQL Server | Depura objetos de banco de dados de SQL Server. |
| Habilitar a depuração do WebView2 | Depura o JavaScript com o depurador baseado no Microsoft Edge (Chromium). |
Perfil de inicialização (ASP.NET Core)
Além das propriedades do .NET 5+, os perfis de inicialização ASP.NET Core incluem várias propriedades adicionais para os diferentes perfis de ASP.NET Core. Essas configurações oferecem 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 dos perfis de inicialização incluem:
| Configuração | Descrição |
|---|---|
| Iniciar o navegador | Selecione se deseja iniciar o navegador padrão ao iniciar a depuração, usando a URL definida 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 é Projeto), 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 nomeado após o projeto, essa propriedade especifica as URLs do servidor Kestrel, normalmente https://localhost:5001 e http://localhost:5000 |
O Visual Studio fornece um perfil IIS Express por padrão e é possível 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 oferecem várias configurações, como o modelo de hospedagem.
| Configuração | Descrição |
|---|---|
| Modelo de hospedagem | 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 do SSL do aplicativo | Para IIS Express, a URL do SSL do aplicativo normalmente é http://localhost:44334. |
Guia Compilação
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, Designer de Projeto.
| Configuração | Descrição |
|---|---|
| Geral>Símbolos de compilação condicional | Definem as constantes DEBUG e TRACE, se selecionadas. Essas constantes habilitam a compilação condicional da Classe Debug e da Classe Trace. Com essas constantes definidas, os métodos da classe Debug e Trace geram saída para a Janela de Saída. Sem essas constantes, os métodos da classe Debug e Trace não são compilados e nenhuma saída será gerada. Em geral, DEBUG é definida na versão de Depuração de uma compilação e indefinida na versão de Lançamento. TRACE é definida tanto nas versões de Depuração quanto de Lançamento. |
| Geral>Otimizar código | A menos que um bug apareça apenas no código otimizado, deixe essa configuração desmarcada nas 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 de origem. |
| 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 Facilitando a depuração de uma imagem. |
| Saída>Caminho de saída de base | Especifica a pasta base para saída intermediária. A saída normalmente segue para bin\Debug para uma compilação de Depuração. |
| Saída>Caminho de saída intermediária de base | Especifica a pasta base para saída intermediária. A saída normalmente segue para obj\Debug para uma compilação de Depuração. |
Símbolos de depuração
É possível escolher as opções a seguir para símbolos de depuração.
Nenhum símbolo foi emitido
Especifica que nenhuma informação de depuração será gerada.
Arquivo PDB, plataforma atual
Produz um arquivo PDB, um arquivo de símbolo portátil e 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 e 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ímbolo portátil no assembly. Nenhum arquivo PDB externo é produzido.
Para obter mais informações, consulte /debug (opções do compilador C#).