Página de Compilação, Designer de Projeto (C#)

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

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

Configuração e plataforma

As opções a seguir permitem que você selecione a configuração e a plataforma para exibir ou modificar.

Configuração

Especifica quais configurações exibir ou modificar. As configurações podem ser Ativas (Depuração) (esse é o padrão), Depurar, Liberar ou Todas as Configurações.

Plataforma

Especifica quais configurações de plataforma exibir ou modificar. A configuração padrão é Ativa (Qualquer CPU). Você pode 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 que você defina várias configurações do compilador C#.

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

Definir constante DEBUG

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

Definir constante TRACE

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

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

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 o C# 8.0 ou posterior.

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

Preferir 32 bits

Se a caixa de seleção Prefer32 bits estiver selecionada, o aplicativo será executado como um aplicativo de 32 bits em versões de 32 bits 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 tamanho do ponteiro dobrará e problemas de compatibilidade poderão ocorrer com outras bibliotecas exclusivamente de 32 bits. É útil executar um aplicativo de 64 bits somente se precisar de mais de 4 GB de memória ou instruções de 64 bits fornecer uma melhoria significativa no desempenho.

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

• Na página Compilar, a lista de destino da plataforma é definida como Qualquer CPU.

• Na Página do Aplicativo, a lista de tipos de saída especifica que o projeto é um aplicativo.

• Na Página do Aplicativo, a lista de estruturas de destino especifica o .NET Framework 4.5.

Permitir código não seguro

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

Otimizar de código

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

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.

de nível de aviso de

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 vírgula ou 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 retornar um erro quando o build encontrar um aviso. Para obter mais informações, consulte /warnaserror (opções do compilador C#).

Nenhum – não trata avisos como erros.

Tudo – trata todos os avisos como erros.

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

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

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-se para interoperabilidade COM

Indica que seu aplicativo gerenciado exporá um objeto COM (um wrapper callable COM) que permite que um objeto COM interaja com seu aplicativo gerenciado. A propriedade Tipo de saída na página Aplicativo do Designer de Projeto para este aplicativo deve ser definida como Biblioteca de Classes para que a propriedade de interoperabilidade Register for COM esteja disponível. Para obter uma classe de exemplo que você pode incluir em seu aplicativo Visual C# e expor como um objeto COM, consulte Exemplo de Classe COM.

Gerar assembly de serialização

Especifica se o compilador usará a Ferramenta de Gerador de Serializador XML (Sgen.exe) para criar assemblies de serialização XML. Os assemblies de serialização podem melhorar o desempenho de XmlSerializer inicialização se você tiver usado essa classe para serializar tipos em seu código. Por padrão, essa opção é definida como Auto, que especifica que os assemblies de serialização serão gerados somente se você tiver usado XmlSerializer para codificar tipos em seu código para XML. Off especifica que assemblies de serialização nunca serão gerados XmlSerializer, independentemente de seu código usar . Ao especificar que os assemblies de serialização sempre serão gerados. Os assemblies de serialização são nomeados TypeName.XmlSerializers.dll. Para obter mais informações, consulte XML Serializer Generator Tool (Sgen.exe).

Avançado

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

Consulte também

• Referência de Propriedades do Projeto
• Opções do compilador C#