Página de Build, Designer de Projeto (C#)

Artigo
03/02/2024

Use a página Compilar do Designer de Projeto para especificar as propriedades de configuração de build do projeto. Essa página se aplica somente a projetos do Visual C#.

Para acessar a página Build, escolha um nó do projeto (não o nó Solução) no Gerenciador de Soluções. Em seguida, escolha Exibir, Páginas de Propriedade no menu. Quando o Designer de Projeto for exibido, escolha a guia Build.

Observação

Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de 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, confira Personalizar o IDE.

Configuração e plataforma

As opções a seguir permitem selecionar a configuração e a plataforma a ser exibida ou modificada.

Observação

Com configurações de build simplificadas, o sistema do projeto determina se é necessário compilar uma versão de depuração ou de liberação. Portanto, essas opções não são exibidas. Para saber mais, consulte Como definir configurações de depuração e versão.

Configuration

Especifica quais definições de configuração exibir ou modificar. As configurações podem ser Ativa (Depuração) (esse é o padrão), Depuração, Versão ou Todas as Configurações.

Plataforma

Especifica quais configurações de plataforma exibir ou modificar. A configuração padrão é Ativo (Qualquer CPU). É possível alterar a plataforma ativa usando o Configuration Manager. Para obter mais informações, consulte Como criar e editar configurações.

Geral

As opções a seguir permitem definir várias configurações do compilador do C#.

Símbolos de compilação condicional

Especifica símbolos nos quais a compilação condicional é executada. Separe os símbolos com um ponto-e-vírgula (";"). Para obter mais informações, consulte /define (opções do compilador C#).

Definir a constante DEBUG

Define DEBUG como um símbolo em todos os arquivos de código-fonte do aplicativo. Selecionar essa opção equivale a usar a opção de linha de comando /define:DEBUG.

Definir a constante TRACE

Define TRACE como um símbolo em todos os arquivos de código-fonte do aplicativo. Selecionar essa opção equivale a usar a opção de linha de comando /define:TRACE.

Destino da plataforma

Especifica o processador de destino do arquivo de saída. Escolha x86 para qualquer processador compatível com Intel de 32 bits, x64 para qualquer processador compatível com Intel de 64 bits, ARM para processadores ARM ou Qualquer CPU para especificar que qualquer processador é aceitável. Qualquer CPU é o valor padrão para projetos, pois permite que o aplicativo seja executado em uma ampla variedade de hardwares.

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

Permite valor nulo

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, confira Contextos anuláveis.

Preferir 32 bits

Se a caixa de seleção Preferir 32 bits estiver marcada, o aplicativo será executado como um aplicativo de 32 bits em versões de 32 e 64 bits do Windows. Se a caixa de seleção estiver desmarcada, o aplicativo será executado como um aplicativo de 32 bits em versões de 32 bits do Windows e como um aplicativo de 64 bits em versões de 64 bits do Windows.

Se você executar um aplicativo como um aplicativo de 64 bits, o ponteiro duplicará de tamanho e poderão ocorrer problemas de compatibilidade com outras bibliotecas que são exclusivamente de 32 bits. É útil executar um aplicativo de 64 bits somente se ele precisa de mais de 4 GB de memória ou se as instruções de 64 bits fornecem uma melhoria de desempenho significativa.

Essa caixa de seleção estará disponível somente se todas as seguintes condições forem verdadeiras:

Na Página Build, a lista Destino da plataforma é definida com Qualquer CPU.
Na Página Aplicativo, a lista Tipo de saída especifica que o projeto é um aplicativo.
Na Página Aplicativo, a lista Estrutura de destino especifica o .NET Framework 4.5.

Permitir código não seguro

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

Otimizar código

Habilita ou desabilita 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#).

Erros e avisos

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

Nível de aviso

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

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

Tratar Avisos como Erros

As configurações a seguir são usadas para especificar quais avisos são tratados como erros. Selecione uma das opções a seguir para indicar em quais condições um erro é retornado quando o build recebe um aviso. Para obter mais informações, consulte /warnaserror (opções do compilador C#).

Nenhum – Não trata nenhum aviso como erro.

Todos – Trata todos os avisos como erros.

Avisos específicos – Trata os avisos especificados como erros. Separe vários números de aviso com uma vírgula ou um ponto-e-vírgula.

Dica

Se você não quiser que os avisos de análise de código sejam tratados como erros, confira Perguntas frequentes sobre análise de código.

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

Especifica o local dos arquivos de saída para a configuração deste projeto. Insira o caminho da saída do build nessa 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 do projeto determina se é necessário compilar uma versão de depuração ou de liberação. O comando Build 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 Understanding Build Configurations (Noções básicas sobre configurações de build).

Arquivo de documentação XML

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

Registrar para interoperabilidade COM

Indica que o aplicativo gerenciado exporá um objeto COM (um COM Callable Wrapper) que permite que um objeto COM interaja com o aplicativo gerenciado. A propriedade Tipo de saída da página Aplicativo do Designer de Projeto desse aplicativo deve ser definida como Biblioteca de Classes para que a propriedade Registrar para a interoperabilidade COM esteja disponível. Para obter uma classe de exemplo que pode ser incluída no aplicativo Visual C# e exposta como um objeto COM, confira Classe COM de exemplo.

Gerar assembly de serialização

Especifica se o compilador usará a ferramenta Gerador de Serializador XML (Sgen.exe) para criar assemblies de serialização XML. Os assemblies de serialização poderão melhorar o desempenho da inicialização de XmlSerializer se você tiver usado essa classe para serializar os tipos no código. Por padrão, essa opção é definida como Automático, que especifica que os assemblies de serialização serão gerados apenas se você tiver usado XmlSerializer para codificar tipos no código em XML. Desativado especifica que os assemblies de serialização nunca devem ser gerados, independentemente de o código usar XmlSerializer. Ativado especifica que os assemblies de serialização sempre devem ser gerados. Os assemblies de serialização são chamados TypeName.XmlSerializers.dll. Para obter mais informações, consulte Ferramenta Gerador de Serializador XML (Sgen.exe).

Avançado

Clique para exibir a caixa de diálogo Configurações de Build Avançadas (C#).