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 índice para navegar entre eles.

Como definir opções

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

• No seu ficheiro *.csproj

  Você pode adicionar propriedades MSBuild para qualquer opção de compilador em seu 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 seguinte trecho de arquivo de projeto 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

  Visual Studio fornece páginas de propriedades para editar propriedades de compilação. Para saber mais sobre eles, consulte Gerenciar propriedades de projetos e soluções - Windows ou Gerenciar propriedades de projetos e soluções - 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 compilação e ASP.NET projetos principais, as opções são retiradas do arquivo de projeto.

A palavra para algumas opções do compilador mudou de projetoscsc.exe e .NET Framework para o novo sistema MSBuild. A nova sintaxe é usada ao longo desta seção. Ambas as versões estão listadas na parte superior de cada página. Por csc.exe, todos os argumentos são listados após a opção e dois pontos. Por exemplo, a -doc opção seria:

-doc:DocFile.xml

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

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

Se você usar a janela Prompt de Comando do Desenvolvedor para 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 Prompt de comando do desenvolvedor para Visual Studio.

O arquivo executável csc.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 determinado computador. Se mais de uma versão do .NET Framework estiver instalada no 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.