Compartilhar via


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#).

Confira também