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

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

Para acessar a página Compilar, escolha um nó de projeto (não o nó de Solução) no Gerenciador de Soluções. Então, escolha Projeto, Propriedades na barra de menus. Quando o Designer de Projeto for exibido, clique na guia Compilar.

Configuração e plataforma

As opções a seguir permitem que você selecione a configuração e a plataforma a ser exibida ou modificada.

• Configuração
  Especifica quais configurações serão exibidas ou modificadas. As configurações podem ser Ativa (depuração) (este é o padrão), Depurar, Versão, ou Todas as Configurações.

• Plataforma
  Especifica quais configurações da plataforma serão exibidas ou modificadas. A configuração padrão é Ativa (qualquer CPU). Você pode alterar a plataforma ativa usando o Gerenciador de Configurações. Para obter mais informações, consulte Como criar e editar configurações de teste.

Geral

As seguintes opções permitem que você configure várias configurações do compilador C#.

• Símbolos de compilação condicional
  Especifica símbolos nos quais se realiza a compilação condicional. Separar símbolos por um ponto-e-vírgula (; “"). Para obter mais informações, consulte /define (opções do compilador C#).

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

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

• CPU de destino
  Especifica o processador a ser direcionado pelo 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 quaisquer processadores ARM ou Qualquer CPU para especificar se qualquer processador é aceitável. Qualquer CPU é o valor padrão para projetos, pois permite que o aplicativo execute na maior parte do hardware.

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

• Prefira 32 bits
  Se a caixa de seleção Prefer32-bit estiver marcada, o aplicativo será executado como um aplicativo de 32 bits em versões de 32 bits e de 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 poderão ocorrer problemas de compatibilidade com outras bibliotecas que sejam exclusivamente de 32 bits. Só será útil executar um aplicativo de 64 bits se ele precisar de mais de 4 GB de memória ou se instruções de 64 bits fornecerem uma melhoria significativa de desempenho.

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

  • Em Compilar Página, a lista de Destino da plataforma é definida como Qualquer CPU.

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

  • Na Página de Aplicativo, a lista de Estrutura de Destino especifica o.NET Framework 4.5.

• Permitir código não seguro
  Permite o código que utiliza a palavra-chave não seguro para compilar. Para obter mais informações, consulte /unsafe (opções do compilador C#).

• Código de otimização
  Habilitar ou desabilitar otimizações realizadas pelo compilador para fazer seu 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 erros e avisos para o processo de compilação.

• Nível de aviso
  Especifica o nível de alertas do compilador a ser apresentado. Para obter mais informações, consulte /warn (opções do compilador C#).

• Suprimir avisos
  Bloqueia a capacidade do compilador para gerar um ou mais avisos. Separar 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 seguintes configurações são usadas para especificar quais avisos são tratados como erros. Selecione uma das seguintes opções indicar em que condições retornar um erro quando a compilação encontrar um aviso. Para obter mais informações, consulte /warnaserror (opções do compilador C#).

• Nenhum
  Não trata avisos como erros.

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

• Todos
  Trata todos os avisos como erros.

Saída

As seguintes definições são usadas para configurar as opções de saída do processo de compilação.

• Caminho de saída
  Especifica a localização dos arquivos de saída para esta configuração de projeto. Digite o caminho de saída de compilação nessa caixa ou escolha o botão Procurar para especificar um caminho. Observe que o caminho é relativo; se você inserir um caminho absoluto, ele será salvo como relativo. O caminho padrão é bin\Debug ou bin\Release\. Para obter mais informações, consulte Configurações Debug e Release projeto.

  Com configurações simplificadas de compilação, o sistema de projeto determina se compila uma versão de depuração ou uma versão de lançamento. O comando de Compilar do menu Depurar (F5) irá colocar a compilação no local de depuração independentemente do Caminho de Saída que você especificar. No entanto, o comando Build no menu Compilar os coloca no local que você especificar. Para obter mais informações, consulte Configurações Debug e Release projeto.

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

• Registrador para COM Interop
  Indica que se seu aplicativo gerenciado exibirá um objeto COM (um invólucro COM callable) que permite a um objeto COM interagir com seu aplicativo gerenciado. A propriedade Tipo de Saída na Página de aplicativo do Designer de Projeto para este aplicativo deve ser definida como Biblioteca de Classes para que a propriedade Registrar para Interoperabilidade COM fique disponível. Para obter uma classe de exemplo que você pode incluir em seu aplicativo Visual C# ou expor como um Objeto COM, consulte Exemplo de classe COM (Guia de Programação em C#).

• Gerar o assembly de serialização
  Especifica se o compilador usará a ferramenta de gerador do serializador XML (Sgen.exe) para criar assemblies de serialização XML. Assemblies de serialização podem melhorar o desempenho de inicialização de XmlSerializer se você usou a classe para serializar em seu código. Por padrão, essa opção é definida como Automático, o que especifica que os assemblies de serialização são gerados somente se você usou XmlSerializer para codificar os tipos no seu código para XML. Desativado especifica que os assemblies de serialização são gerados nunca, independentemente se seu código usa XmlSerializer. Ativado especifica que os assemblies de serialização são gerados sempre. Assemblies de serialização são nomeados TypeName.XmlSerializers.dll. Para obter mais informações, consulte Ferramenta geradora de serializador de XML (Sgen.exe).

• Avançado
  Clique para exibir a caixa de diálogo Caixa de diálogo Configurações de Compilação Avançadas (C#).

Consulte também

Conceitos

Referência de propriedades de projeto

Outros recursos

Opções do compilador de C#