Opções do compilador C#

Esta seção descreve as opções interpretadas pelo compilador C#. As opções são agrupadas em artigos separados com base no que controlam, por exemplo, recursos de linguagem, geração de código e saída. Use o sumário para navegar entre eles.

Como definir opções

Há duas maneiras diferentes de definir opções de compilador em projetos do .NET:

• No arquivo *.csproj

  Você pode adicionar propriedades do MSBuild para qualquer opção de compilador no arquivo *.csproj no formato XML. O nome da propriedade é o mesmo que a opção do compilador. O valor da propriedade define o valor da opção do compilador. Por exemplo, o snippet de arquivo de projeto a seguir define a LangVersion propriedade.

  <PropertyGroup>
    <LangVersion>preview</LangVersion>
  </PropertyGroup>
  

  Para obter mais informações sobre como definir opções em arquivos de projeto, consulte o artigo propriedades do MSBuild para projetos do SDK do .NET.

• Usando as páginas de propriedades do Visual Studio

  O Visual Studio fornece páginas de propriedades para editar propriedades de build. Para saber mais sobre eles, consulte Gerenciar propriedades de projeto e solução – Windows ou Gerenciar propriedades de projeto e solução – Mac.

Projetos do .NET Framework

Importante

Esta seção se aplica somente a projetos do .NET Framework.

Além dos mecanismos descritos acima, você pode definir opções de compilador usando dois métodos adicionais para projetos do .NET Framework:

• Argumentos de linha de comando para projetos do .NET Framework: os projetos do .NET Framework usam csc.exe em vez de dotnet build criar projetos. Você pode especificar argumentos de linha de comando para csc.exe para projetos do .NET Framework.
• Páginas de ASP.NET compiladas: os projetos do .NET Framework usam uma seção do arquivo web.config para compilar páginas. Para o novo sistema de build e projetos do ASP.NET Core, as opções são retiradas do arquivo de projeto.

A palavra para algumas opções do compilador foi alterada de projetos docsc.exe e do .NET Framework para o novo sistema MSBuild. A nova sintaxe é usada nesta seção. Ambas as versões são listadas na parte superior de cada página. Para csc.exe, todos os argumentos são listados seguindo a opção e dois-pontos. Por exemplo, a opção -doc seria:

-doc:DocFile.xml

Você pode invocar o compilador C# digitando o nome do arquivo executável (csc.exe) em um prompt de comando.

Para projetos do .NET Framework, você também pode executar csc.exe na linha de comando. Cada opção do compilador está disponível em dois formulários: -option e /option. Em projetos Web do .NET Framework, você especifica opções para compilar code-behind no arquivo web.config . Para obter mais informações, consulte <compiler> Elemento.

Se você usar o Prompt de Comando do Desenvolvedor para a janela do Visual Studio , todas as variáveis de ambiente necessárias serão definidas para você. Para obter informações sobre como acessar essa ferramenta, consulte o Prompt de Comando do Desenvolvedor para Visual Studio.

O arquivo executávelcsc.exe geralmente está localizado na pasta Microsoft.NET\Framework\<Version> no diretório do Windows . Sua localização pode variar dependendo da configuração exata de um computador específico. Se mais de uma versão do .NET Framework estiver instalada em seu computador, você encontrará várias versões desse arquivo. Para obter mais informações sobre essas instalações, consulte Como determinar quais versões do .NET Framework estão instaladas.