Designer de Projeto do .NET

Use o do Designer de Projeto para especificar as configurações e as propriedades do projeto para .NET Core e .NET 5+. Para .NET Framework, consulte O que é o Designer de Projeto do .NET?.

Para acessar o Designer de Projeto, escolha um nó de projeto (não o nó Solution) nodo Gerenciador de Soluções do . Em seguida, escolha propriedades do Projectna barra de menus. O Designer de Projeto é exibido.

Aplicativo, configurações gerais

As opções a seguir permitem que você defina configurações gerais para o aplicativo.

Output type

Especifica o tipo de aplicativo a ser compilado. Os valores são diferentes dependendo do tipo de projeto. Por exemplo, para um projeto do Aplicativo de Console , você pode especificar de Aplicativos do Windows,de Aplicativo do Console ou biblioteca de classes como o tipo de saída.

Para obter mais informações sobre a propriedade tipo de saída , consulte /target (Opções do Compilador C#).

Para obter informações sobre como acessar essa propriedade programaticamente, consulte OutputType.

Target Framework

Especifica a versão do .NET direcionada ao aplicativo. Essa opção pode ter valores diferentes dependendo de quais versões do .NET estão instaladas em seu computador.

Para um projeto direcionado ao .NET Core ou ao .NET 5+, as versões disponíveis podem aparecer da seguinte maneira:

Para obter mais informações, confira Visão geral do direcionamento de estrutura.

Target OS

Especifica o sistema operacional que o projeto terá como destino. Combinado com a estrutura de destino, isso gera um TF específico do sistema operacional do .NET 5+ .

Startup object

Define o ponto de entrada a ser chamado quando o aplicativo é carregado. Geralmente, isso é definido como o formulário principal em seu aplicativo ou para o procedimento Main que deve ser executado quando o aplicativo é iniciado. Como as bibliotecas de classes não têm um ponto de entrada, a única opção para essa propriedade é (Não definida).

Por padrão, em um projeto de aplicativo WPF, essa opção é definida como (Não definido). A outra opção é [projectname].App. Em um projeto do WPF, você deve definir o URI de inicialização para carregar um recurso de interface do usuário quando o aplicativo for iniciado. Para fazer isso, abra o arquivo Application.xaml em seu projeto e defina a propriedade como um arquivo de .xaml em seu projeto, como Window1.xaml. Para obter uma lista de elementos raiz aceitáveis, consulte StartupUri. Você também deve definir um método public static void Main() em uma classe no projeto. Essa classe será exibida na lista do objeto Startup como ProjectName.ClassName. Em seguida, você pode selecionar a classe como o objeto de inicialização.

Consulte /main (Opções do Compilador C#) para obter mais informações. Para acessar essa propriedade programaticamente, consulte StartupObject.

Assembly name

Especifica o nome do arquivo de saída que conterá o manifesto do assembly. Alterar essa propriedade também altera a propriedade Nome de Saída.

Você também pode fazer essa alteração na linha de comando usando /out (Opções do Compilador C#).

Para acessar essa propriedade programaticamente, consulte AssemblyName.

Default namespace

Especifica o namespace base para arquivos adicionados ao projeto.

Consulte namespace para obter mais informações sobre como criar namespaces em seu código.

Para acessar essa propriedade programaticamente, consulte RootNamespace.

Configurações de Aplicativos, Recursos do Win32

Icon

Define o arquivo .ico que você deseja usar como ícone de programa. Clique em Procurar para procurar um gráfico existente ou digite o nome do arquivo desejado. Consulte /win32icon (Opções do Compilador C#) para obter mais informações.

Para acessar essa propriedade programaticamente, consulte ApplicationIcon.

Para obter informações sobre como criar um ícone, consulte Editor de imagens para ícones.

Resources

A opção Recursos ajuda você a definir as configurações de recursos para seu aplicativo. Por padrão, as opções ícone de e manifesto estão habilitadas. Isso permite que você selecione seu próprio ícone ou selecione diferentes opções de geração de manifesto. Deixe esse botão de opção selecionado, a menos que você esteja fornecendo um arquivo de recurso para o projeto.

Se você selecionar de arquivo de recurso, configure um arquivo de recurso para o projeto. Insira um nome de caminho ou use o botão Procurar para adicionar um arquivo de recurso Win32 ao projeto. Para obter mais informações, consulte Criar arquivos de recursos para aplicativos .NET.

Manifest

Seleciona uma opção de geração de manifesto quando o aplicativo é executado no Windows em UAC (Controle de Conta de Usuário). Essa opção pode ter os seguintes valores:

• manifesto de inserção com configurações padrão. Dá suporte à maneira típica em que o Visual Studio opera no Windows, que é inserir informações de segurança no arquivo executável do aplicativo, especificando que requestedExecutionLevel ser AsInvoker. Essa é a opção padrão.

• Criar aplicativo sem um manifesto. Esse método é conhecido como de virtualização. Use essa opção para compatibilidade com aplicativos anteriores.

• Usar um manifesto personalizado. Permite que você insira um caminho ou navegue até um manifesto personalizado para o projeto.

Configurações de Usos Globais

usos globais implícitos

Habilita ou desabilita usos globais, que permitem usar tipos definidos em um namespace sem especificar o namespace totalmente qualificado.

gerenciar de usos globais implícitos

Adicione e exclua manualmente os usos globais para uso em seus projetos.

Build, configurações gerais

símbolos de compilação condicional

Especifica símbolos nos quais executar a compilação condicional. Separar símbolos com um ponto e vírgula (";"). Para obter mais informações, consulte /define (Opções do Compilador C#).

depurar símbolos personalizados

Especifica símbolos para compilação condicional para builds de depuração. Os símbolos de depuração padrão são exibidos em uma cadeia de caracteres, separada por ponto e vírgula.

liberar símbolos personalizados

Especifica símbolos para compilação condicional para builds de versão. Os símbolos de versão padrão são exibidos em uma cadeia de caracteres, separada por ponto e vírgula.

Platform Target

Especifica o processador a ser direcionado pelo arquivo de saída. Escolha x86 para qualquer processador compatível com Intel de 32 bits, escolha x64 para qualquer processador compatível com Intel de 64 bits, escolha ARM para processadores ARM ou escolha Qualquer de CPU para especificar que qualquer processador seja aceitável. Qualquer de CPU é o valor padrão para projetos, pois permite que o aplicativo seja executado no intervalo mais amplo de hardware.

Para obter mais informações, consulte /platform (opções do compilador C#).

Nullable

Especifica o contexto anulável em C# em todo o projeto. Essa opção de interface do usuário foi introduzida no Visual Studio 16.5 e só está habilitada para projetos que usam o C# 8.0 ou posterior.

Para obter mais informações, consulte contextos anuláveis.

Gerar informações do assembly

Especifica se propriedades de projeto relacionadas ao pacote são transformadas em atributos de assembly. Para obter mais informações, consulte a propriedade GenerateAssemblyInfo.

Unsafe code

Permite que o código que usa a palavra-chave não segura seja compilado. Para obter mais informações, consulte /unsafe (Opções do compilador C#).

Optimize code

Habilite ou desabilite as otimizações executadas pelo compilador para tornar o arquivo de saída menor, mais rápido e mais eficiente. Para obter mais informações, consulte /optimize (Opções do Compilador C#).

Debug symbols

Especifica o tipo de informações de depuração geradas pelo compilador. Para obter informações sobre como configurar o desempenho de depuração de um aplicativo, consulte opção de compilador de DebugType. Essa configuração tem as seguintes opções:

• none

  Especifica que nenhuma informação de depuração será gerada.

• full

  Habilita a anexação de um depurador ao programa em execução.

• pdbonly

  Permite a depuração do código-fonte quando o programa é iniciado no depurador, mas só exibirá o assembler quando o programa em execução estiver anexado ao depurador.

• portable

  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.

• embedded

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

Configurações de build, erros e avisos

As configurações a seguir são usadas para configurar as opções de erro e aviso para o processo de build.

Warning level

Especifica o nível a ser exibido para avisos do compilador. Para obter mais informações, consulte /warn (opções do compilador C#).

suprimir avisos específicos

Bloqueia a capacidade do compilador de gerar um ou mais avisos específicos. Separe vários números de aviso com vírgula ou ponto-e-vírgula. Para obter mais informações, consulte /nowarn (opções do compilador C#).

Tratar avisos como erros

Selecione se os avisos são tratados como erros durante o processo de build. Para obter mais informações, consulte /warnaserror (opções do compilador C#).

Tratar avisos específicos como erros

Especifique quais avisos são tratados como erros. Separe vários números de aviso com vírgula ou ponto-e-vírgula.

Configurações de build, saída

As configurações a seguir são usadas para configurar as opções de saída para o processo de build.

caminho de saída base

Especifica o local dos arquivos de saída para a configuração deste projeto. Insira o caminho da saída de build nesta caixa ou escolha o botão Procurar para especificar um caminho. O caminho é relativo; se você inserir um caminho absoluto, ele será salvo como relativo. O caminho padrão é bin\Debug ou bin\Release\.

Com configurações de build simplificadas, o sistema de projeto determina se uma versão de depuração ou de versão deve ser compilada. O comando Compilar do menu Depurar (F5) colocará o build no local de depuração, independentemente do caminho de saída você especificar. No entanto, o comando Build do menu Build o coloca no local especificado. Para obter mais informações, consulte Noções básicas sobre configurações de build.

Reference assembly

Especifica se um assembly de referência que contém a API pública do projeto.

Documentation file

Especifica o nome de um arquivo no qual os comentários da documentação serão processados. Para obter mais informações, consulte /doc (opções do compilador C#).

Configurações de build, eventos

Para obter informações sobre as configurações de evento de build, consulte Especificar eventos de build (C#).

Configurações de compilação, publicação

Publishing

Permite que o destino de publicação do MSBuild seja executado. Para obter mais informações, consulte a propriedade IsPublishable do MSBuild.

Publish trimmed

Especifica se o corte está habilitado durante o processo de publicação. Para obter mais informações, consulte propriedades relacionadas ao corte.

Publicar AOT nativo

Especifica se um aplicativo que é autocontido e que foi compilado antecipadamente (AOT) para código nativo. Para obter mais informações, consulte Implantação do AOT nativo.

Configurações de build e de nomenclatura forte

Assinar o assembly

Marque esta caixa de seleção para assinar o assembly e criar um arquivo de chave fortemente nomeado. Para obter mais informações sobre como assinar o assembly usando odo Designer de Projetos do , consulte Como assinar um assembly (Visual Studio). Para obter mais informações, consulte assemblies com nome forte.

Essa opção usa a ferramenta Al.exe fornecida pelo SDK (Windows Software Development Kit) para assinar o assembly. Para obter mais informações sobre Al.exe, consulte How to: Sign an Assembly with a Strong Name.

lista de de arquivo de chave de nome forte

Permite que você especifique um arquivo de chave fortemente nomeado novo ou existente usado para assinar o assembly. Selecione <Procurar...> para selecionar um arquivo de chave existente.

Somente

Marque esta caixa de seleção para habilitar a assinatura de atraso. Para obter mais informações, consulte Assinar com atraso um assembly.

Observe que um projeto assinado por atraso não será executado e não poderá ser depurado. No entanto, você pode usar o Sn.exe (Strong Name Tool) com a opção -Vr para ignorar a verificação durante o desenvolvimento.

Configurações avançadas e de build

As opções a seguir permitem definir configurações avançadas de build.

Language version

Links para /langversion (opções do compilador C#), que fornece informações sobre como uma versão de idioma padrão é escolhida com base na estrutura de destino de um projeto.

Verificar se há de estouro aritmético

Especifica se uma instrução aritmética de inteiro que não está no escopo do marcada ou palavras-chave desmarcadas e que resulta em um valor fora do intervalo do tipo de dados causará uma exceção em tempo de execução. Para obter mais informações, consulte /checked (Opções do compilador C#).

Deterministic

Especifica se a saída equivalente de byte para byte deve ser produzida da mesma fonte de entrada. Para obter mais informações, consulte Opções do compilador C# que controlam a geração de código.

relatório de erros do compilador interno

Especifica se os erros do compilador devem ser relatados à Microsoft. Se definido como prompt (o padrão), você receberá um prompt se ocorrer um erro interno do compilador, oferecendo a opção de enviar um relatório de erro eletronicamente à Microsoft. Se definido como enviar, um relatório de erros será enviado automaticamente. Se definido como fila, os relatórios de erro serão enfileirados. Se definido como nenhum, o erro será relatado apenas na saída de texto do compilador. Para obter mais informações, consulte /errorreport (Opções do compilador C#).

File Alignment

Especifica o tamanho das seções no arquivo de saída. Os valores válidos são 512, 1024, 2048, 4096e 8192. Esses valores são medidos em bytes. Cada seção será alinhada em um limite que é um múltiplo desse valor, afetando o tamanho do arquivo de saída. Para obter mais informações, consulte /filealign (Opções do compilador C#).

Pacote, configurações gerais

As propriedades nesta seção são usadas para configurar pacotes, geralmente correspondentes a propriedades em um arquivo de .nuspec NuGet. Para obter mais informações, consulte arquivo .nuspec.

Configurações de pacote, licença

Package License

Especifica se uma expressão de licença ou arquivo de licença deve ser incluído no pacote. Para obter mais informações, consulte o elemento de licença de .

Configurações de pacote, símbolo

Produzir um pacote de símbolos

Especifica se um pacote de símbolos deve ser criado para depuração. Para obter mais informações, consulte Criando pacotes de símbolos (.snupkg).

Análise de Código, Todas as configurações do analisador

Executar no de build

Especifica se a análise do código-fonte deve ser executada ao compilar o projeto. Para obter mais informações, consulte Desabilitar a análise do código-fonte para o .NET.

executar em de análise dinâmica

Especifica se a análise de código-fonte dinâmica deve ser executada ao compilar o projeto. Para obter mais informações, consulte Desabilitar a análise do código-fonte para o .NET.

Análise de Código, configurações do analisador do .NET

Impor estilo de código no build

Especifica se violações de estilo de código do .NET são relatadas ao compilar o projeto. Para obter mais informações, consulte Impor estilos de código no build.

Habilitar analisadores do .NET

Habilita ou desabilita os analisadores da plataforma de compilador .NET (Roslyn). Para obter mais informações, consulte Habilitar ou instalar analisadores .NET de primeira parte.

Analysis level

Especifica o conjunto de analisadores a serem executados no projeto. Para obter mais informações, consulte seção atualizações mais recentes no artigo de visão geral da análise de código.

Depuração, configurações gerais

Selecione o link para abrir a interface do usuário dos perfis de inicialização de depuração. Essa interface do usuário permite que você adicione e configure perfis diferentes a serem usados durante a depuração. Cada nome de perfil aparece como uma opção inicial na lista Iniciar Depuração.

Para projetos do ASP.NET Core, as configurações na interface do usuário dos perfis de inicialização correspondem às configurações no arquivo launchSettings.json do projeto. Para obter informações detalhadas sobre como esse arquivo é usado no desenvolvimento ASP.NET, consulte Desenvolvimento e launchSettings.json.

Recursos, configurações gerais

Selecione o link para abrir o arquivo de recursos de assembly RESX. Para obter mais informações, consulte página Configurações, Designer de Projeto.

See also

de interface do usuário das propriedades do projeto renovadas