Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você pode alterar as configurações de depuração do projeto em 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 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#.
Acessar as configurações de depuração do perfil de inicialização
Selecione o projeto no Gerenciador de Soluções e selecione o ícone Propriedades ou clique com o botão direito do mouse no projeto e selecione Propriedades. Em seguida, 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.
Como alternativa, você pode acessar o perfil de lançamento no menu Debug selecionando <nome do projeto>Propriedades 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 em depuração. 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 máquina remota | Na depuração remota, selecione essa opção e insira o nome do destino de depuração remota ou um nome de servidor Msvsmon. A localização de um aplicativo no computador remoto é especificada pela propriedade Caminho de Saída na aba Build. O local deve ser um diretório 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 Environments. |
| 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 do SQL Server. |
| Habilitar a depuração do WebView2 | Depura JavaScript com o depurador baseado em Microsoft Edge (Chromium). |
Perfil de inicialização (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 no Usar vários ambientes no ASP.NET Core.
As configurações fornecidas na interface de perfis de inicialização incluem os seguintes itens.
| Configuração | Descrição |
|---|---|
| Abrir 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 com o nome do projeto (ou seja, a propriedade commandName no 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 de 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 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 o IIS Express, a URL SSL do aplicativo . |
Configurações de build
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, confira Página de compilação, Designer de Projeto.
| Configuração | Descrição |
|---|---|
| Geral>Símbolos de compilação condicional | Defina as constantes DEBUG e TRACE, se selecionadas. Essas constantes permitem a compilação condicional da classe de depuração 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 de classe Depuração e Rastreamento não são compilados e nenhuma saída é gerada. Normalmente, DEBUG é ativado na versão de depuração de uma compilação e desativado na versão de lançamento. TRACE é definido nas versões Debug e Release. |
| Geral>Otimizar o código | A menos que um bug apareça apenas no código otimizado, deixe essa configuração desmarcada para builds de depuração. O código otimizado é mais difícil de depurar, pois 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 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
Você pode 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ímbolos específico da plataforma que fornece a outras ferramentas, especialmente aos depuradores, informações sobre o conteúdo do 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 a 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.
Inserido 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#).