Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Você pode alterar as configurações de depuração do projeto C# na guia Depuração e na guia de Compilação 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, consulte Configurações de depuração e lançamento.
Importante
Essas configurações não se aplicam ao .NET Framework ou aplicativos UWP. Para definir as configurações de depuração para o .NET Framework, consulte Configurações do Project para configurações de depuração em C#.
Aceder às definições de depuração do perfil de arranque
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. Em seguida, selecione Abrir interface do usuário de 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.
Como alternativa, você pode acessar o perfil de inicialização no menu Debug selecionando <projectname>Debug Properties.
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 da aplicação que está a ser depurada. 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 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 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 de perfis de arranque incluem o seguinte.
| Configuração | Descrição |
|---|---|
| Inicie o navegador | Selecione se deseja iniciar o navegador padrão quando começar a depuração, utilizando a URL que definiu na definição de 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 em launchSettings.json é Project), o servidor Kestrel ouve 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 URL SSL de Aplicação é geralmente http://localhost:44334. |
Configurações de 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, Project Designer.
| Configuração | Descrição |
|---|---|
| Símbolos de compilação condicional gerais> | Defina as constantes DEBUG e TRACE se selecionadas. Essas constantes permitem 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 Debug de uma compilação e não definido na versão 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 em modo de depuração. |
| 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 numa 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 na assemblagem. Não é produzido nenhum ficheiro .PDB externo.
Para obter mais informações, consulte /debug (C# Compiler Options).