Designer de Projetos .NET
Use o Project Designer
Para acessar o Designer de Projeto, escolha um nó do projeto (não o nó Solução
Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio neste artigo. Você pode estar usando uma edição diferente do Visual Studio ou configurações de ambiente diferentes. Para obter mais informações, consulte Personalizar o IDE.
Aplicação, Configurações gerais
As opções a seguir permitem que você defina configurações gerais para o aplicativo.
Tipo de saída
Especifica o tipo de aplicativo a ser compilado. Os valores são diferentes dependendo do tipo de projeto. Por exemplo, para um projeto de Aplicativo de Console
Para obter mais informações sobre o tipo propriedade
Para obter informações sobre como acessar essa propriedade programaticamente, consulte OutputType.
Target Framework
Especifica a versão do .NET que o aplicativo destina. Esta opção pode ter valores diferentes, dependendo de quais versões do .NET estão instaladas no seu computador.
Para um projeto destinado ao .NET Core ou .NET 5+, as versões disponíveis podem aparecer da seguinte maneira:
Observação
Para aplicativos ClickOnce, os pacotes de pré-requisitos listados na caixa de diálogo pré-requisitos são definidos automaticamente na primeira vez que você abre a caixa de diálogo. Se, posteriormente, você alterar a estrutura de destino do projeto, deverá selecionar os pré-requisitos manualmente para corresponder à nova estrutura de destino.
Para obter mais informações, consulte Visão geral da segmentação do Framework.
do SO de destino
Especifica o sistema operacional que o projeto terá como destino. Combinado com a estrutura de destino, isso gera um TF específico do .NET 5+ OS.
Objeto de inicialização
Define o ponto de entrada a ser chamado quando o aplicativo é carregado. Geralmente, isso é definido para 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, sua única opção para essa propriedade é (Não definido).
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 WPF, você deve definir o URI de inicialização para carregar um recurso de interface do usuário quando o aplicativo é iniciado. Para fazer isso, abra o arquivo de Application.xaml public static void Main() em uma classe no projeto. Essa classe aparecerá na lista de
Consulte /main (C# Compiler Options) para obter mais informações. Para aceder a esta propriedade programaticamente, consulte StartupObject.
Nome do assembly
Especifica o nome do arquivo de saída que conterá o manifesto do assembly. Alterar essa propriedade também altera a propriedade Output Name.
Você também pode fazer essa alteração na linha de comando usando /out (Opções do compilador C#).
Para aceder a esta propriedade programaticamente, consulte AssemblyName.
Namespace padrão
Especifica o namespace base para arquivos adicionados ao projeto.
Consulte de namespace para obter mais informações sobre como criar namespaces em seu código.
Para aceder a esta propriedade programaticamente, consulte RootNamespace.
Aplicativo, configurações de recursos do Win32
Ícone
Define o arquivo de .ico que você deseja usar como ícone do programa. Clique Procurar para procurar um gráfico existente ou digite o nome do arquivo desejado. Consulte /win32icon (C# Compiler Options) para obter mais informações.
Para aceder a esta propriedade programaticamente, consulte ApplicationIcon.
Para obter informações sobre como criar um ícone, consulte Editor de imagens para ícones.
Recursos
A opção Recursos
Se você selecionar 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.
Manifesto
Seleciona uma opção de geração de manifesto quando o aplicativo é executado no Windows em Controle de Conta de Usuário (UAC). Esta opção pode ter os seguintes valores:
Incorporar manifesto com as configurações padrão. Suporta a maneira típica em que o Visual Studio opera no Windows, que é incorporar informações de segurança no arquivo executável do aplicativo, especificando que
requestedExecutionLevelserAsInvoker. Esta é a opção padrão.Criar aplicativo sem um manifesto. Esse método é conhecido como virtualização . Use esta opção para compatibilidade com aplicativos anteriores.
Use um manifesto personalizado. Permite inserir um caminho ou navegar até um manifesto personalizado para o projeto.
Configurações de Usos Globais
Utilizações globais implícitas
Habilita ou desabilita usos globais, que permitem que você use tipos definidos em um namespace sem especificar o namespace totalmente qualificado.
gerenciar usos globais implícitos
Adicione e exclua manualmente usos globais para uso em seus projetos.
Construir, Configurações gerais
Símbolos de compilação condicional
Especifica símbolos nos quais executar a compilação condicional. Separe símbolos com ponto e vírgula (";"). Para obter mais informações, consulte /define (C# Compiler Options).
Depurar símbolos personalizados
Especifica símbolos para compilação condicional para compilações de depuração. Os símbolos de depuração padrão são exibidos em uma cadeia de caracteres, separados por ponto-e-vírgula.
Liberar símbolos personalizados
Especifica símbolos para compilação condicional para compilações de versão. Os símbolos de liberação padrão são exibidos em uma cadeia de caracteres, separados por ponto-e-vírgula.
de destino da plataforma
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 é aceitável. Qualquer de CPU é o valor padrão para projetos, porque permite que o aplicativo seja executado na mais ampla gama de hardware.
Para obter mais informações, consulte /platform (C# Compiler Options).
anulável
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 C# 8.0 ou posterior.
Para obter mais informações, consulte Nullable Contexts.
Gerar informações de montagem
Especifica se propriedades de projeto relacionadas ao pacote são transformadas em atributos de assembly. Para obter mais informações, consulte a propriedade
Código não seguro
Permite que o código que usa a palavra-chave
Otimizar de código
Habilite ou desabilite otimizações executadas pelo compilador para tornar seu arquivo de saída menor, mais rápido e mais eficiente. Para obter mais informações, consulte /otimize (C# Compiler Options).
Símbolos de depuração
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 DebugType opção do compilador. Essa configuração tem as seguintes opções:
nenhuma
Especifica que nenhuma informação de depuração será gerada.
completa
Permite anexar 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.
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
Incorpora informações de símbolos portáteis no assembly. Sem externo . O arquivo PDB é produzido.
Para obter mais informações, consulte /debug (C# Compiler Options).
Configurações de compilação, erros e avisos
As configurações a seguir são usadas para configurar as opções de erro e aviso para o processo de compilação.
Nível de alerta
Especifica o nível a ser exibido para avisos do compilador. Para obter mais informações, consulte /warn (C# Compiler Options).
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 compilação. Para obter mais informações, consulte /warnaserror (C# Compiler Options).
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.
Dica
Se você não quiser que os avisos de análise de código sejam tratados como erros, consulte Perguntas frequentes sobre análise de código.
Configurações de compilação, saída
As configurações a seguir são usadas para configurar as opções de saída para o processo de compilação.
Caminho de saída base
Especifica o local dos arquivos de saída para a configuração deste projeto. Digite o caminho da saída da compilação 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 compilação simplificadas, o sistema de projeto determina se deve construir uma versão de depuração ou de lançamento. O comando Build do menu Debug (F5) colocará a compilação 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 compilação.
Montagem de referência
Especifica se deve ser gerado um assembly de referência contendo a API pública do projeto.
Ficheiro de documentação
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#).
Compilação, configurações de eventos
Para obter informações sobre as configurações de evento de compilação, consulte Especificar eventos de compilação (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 MSBuild IsPublishable.
Publicar cortado
Especifica se o corte está habilitado durante o processo de publicação. Para obter mais informações, consulte Propriedades relacionadas a Trim.
Publicar AOT nativo
Especifica se deve ser produzido um aplicativo autônomo e que tenha sido compilado antecipadamente no tempo (AOT) para código nativo. Para obter mais informações, consulte implantação nativa do AOT.
Configurações de nomenclatura Build, Strong
Assine a assembleia
Marque essa caixa de seleção para assinar o assembly e criar um arquivo de chave com nome forte. Para obter mais informações sobre como assinar o assembly usando o Project Designer, consulte Como assinar um assembly (Visual Studio). Para obter mais informações, consulte Assemblies de nome forte.
Esta opção usa a ferramenta Al.exe fornecida pelo Windows Software Development Kit (SDK) para assinar o assembly. Para obter mais informações sobre Al.exe, consulte Como assinar um assembly com um nome forte.
Lista de de arquivo de chave de nome forte
Permite especificar um arquivo de chave com nome forte novo ou existente que é usado para assinar o assembly. Selecione <Procurar...> para selecionar um arquivo de chave existente.
Sinal de atraso apenas
Marque essa caixa de seleção para habilitar a assinatura de atraso. Para obter mais informações, consulte Atrasar a assinatura de um assembly.
Observe que um projeto assinado com atraso não será executado e não poderá ser depurado. No entanto, você pode usar o
Observação
Quando você assina um assembly, nem sempre tem acesso a uma chave privada. Por exemplo, uma organização pode ter um par de chaves bem guardado ao qual os desenvolvedores não têm acesso diariamente. A chave pública pode estar disponível, mas o acesso à chave privada é restrito a alguns indivíduos. Nesse caso, você pode usar atrasado ou de assinatura parcial para fornecer a chave pública, adiando a adição da chave privada até que o assembly seja entregue.
Compilação, Configurações avançadas
As opções a seguir permitem que você defina configurações avançadas de compilação.
Versão linguística
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.
Verifique se há estouro aritmético
Especifica se uma instrução aritmética inteira que não está no escopo do verificado ou palavras-chave não verificadas 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 (C# Compiler Options).
determinística
Especifica se a saída equivalente byte por 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 interno de erros do compilador
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, dando-lhe a opção de enviar um relatório de erro eletronicamente para a Microsoft. Se definido como enviar, um relatório de erros será enviado automaticamente. Se definido como fila, os relatórios de erros 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 (C# Compiler Options).
alinhamento de arquivos
Especifica o tamanho das seções no arquivo de saída. Os valores válidos são 512, 1024, 2048, 4096e 8192. Estes 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 correspondendo a propriedades em um arquivo de .nuspec do NuGet
Pacote, Configurações de licença
Licença de Pacote
Especifica se uma expressão de licença ou um arquivo de licença deve ser incluído em seu pacote. Para obter mais informações, consulte o elemento license.
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 na compilação
Especifica se a análise do código-fonte deve ser executada quando você cria o projeto. Para obter mais informações, consulte Desabilitar a análise do código-fonte para .NET.
Executar em análise ao vivo
Especifica se a análise do código-fonte ao vivo deve ser executada ao criar o projeto. Para obter mais informações, consulte Desabilitar a análise do código-fonte para .NET.
Análise de código, configurações do analisador .NET
Impor estilo de código na compilação
Especifica se as violações de estilo de código .NET são relatadas ao criar o projeto. Para obter mais informações, consulte Impor estilos de código na compilação.
Habilitar analisadores .NET
Habilita ou desabilita os analisadores de plataforma de compilador .NET (Roslyn). Para obter mais informações, consulte Habilitar ou instalar analisadores .NET primários.
Nível de análise
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.
Depurar, Configurações gerais
Selecione o link para abrir a interface do usuário de perfis de inicialização de depuração. Essa interface do usuário permite que você adicione e configure diferentes perfis para usar durante a depuração. Cada nome de perfil aparece como uma opção de início na lista
Para projetos ASP.NET Core, as configurações na interface do usuário de 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, Project Designer.