Opções de compilador C#

Esta secçã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, características linguísticas, geração de códigos e saída. Use a tabela de conteúdos para navegar entre eles.

Como definir opções

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

• No seu ficheiro *.csproj

  Pode adicionar propriedades MSBuild para qualquer opção de compilador no seu ficheiro *.csproj no formato XML. O nome da propriedade é o mesmo que a opção de compilador. O valor da propriedade define o valor da opção compilador. Por exemplo, o seguinte corte de ficheiro de projeto define a LangVersion propriedade.

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

  Para obter mais informações sobre a definição de opções em ficheiros de projetos, consulte o artigo Propriedades MSBuild para Projetos .NET SDK.

• Usando as páginas Visual Studio Propriedade

  Visual Studio fornece páginas de propriedade para editar propriedades de construção. Para saber mais sobre eles, consulte Gerir propriedades de projeto e solução - Windows ou Gerir propriedades de projeto e solução - Mac.

projetos .NET Framework

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

• Argumentos de linha de comando para projetos .NET Framework: .NET Framework os projetos usam csc.exe em vez de dotnet build construir projetos. Pode especificar os argumentos da linha de comando para csc.exe para projetos .NET Framework.
• Páginas compiladas ASP.NET: .NET Framework os projetos utilizam uma secção do ficheiro web.config para compilar páginas. Para o novo sistema de construção, e ASP.NET Core projetos, as opções são tomadas a partir do arquivo do projeto.

A palavra para algumas opções de compilador mudou de projetos decsc.exe e .NET Framework para o novo sistema MSBuild. A nova sintaxe é utilizada em toda esta secção. Ambas as versões estão listadas no topo de cada página. Para csc.exe, quaisquer argumentos são listados seguindo a opção e um cólon. Por exemplo, a opção -doc seria:

-doc:DocFile.xml

Pode invocar o compilador C# digitando o nome do seu ficheiro executável (csc.exe) num pedido de comando.

Para .NET Framework projetos, também pode executar csc.exe a partir da linha de comando. Todas as opções de compilador estão disponíveis em duas formas: -opção e /opção. Em .NET Framework projetos web, especifica opções para compilar códigos no ficheiro web.config. Para obter mais informações, consulte <o elemento compilador>.

Se utilizar o Pedido de Comando do Desenvolvedor para Visual Studio janela, todas as variáveis ambientais necessárias estão definidas para si. Para obter informações sobre como aceder a esta ferramenta, consulte o Pedido de Comando do Desenvolvedor para Visual Studio.

O ficheiro executávelcsc.exe encontra-se normalmente na pasta Microsoft.NET\Framework\<Versão> sob o diretório Windows. A sua localização pode variar dependendo da configuração exata de um determinado computador. Se mais de uma versão de .NET Framework for instalada no seu computador, encontrará várias versões deste ficheiro. Para obter mais informações sobre estas instalações, consulte Como: determinar quais as versões do .NET Framework instaladas.