Opções do compilador de 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 eles controlam, por exemplo, recursos de idioma, 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 .NET:

  • Em seu * arquivo. csproj

    você pode adicionar MSBuild propriedades para qualquer opção de compilador em seu arquivo * . csproj em 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 trecho 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 MSBuild propriedades para projetos do SDK do .net.

  • usando as páginas de propriedades de Visual Studio

    Visual Studio fornece páginas de propriedades para editar propriedades de compilação. para saber mais sobre eles, consulte gerenciar propriedades do projeto e da solução-Windows ou gerenciar propriedades do projeto e da solução-Mac.

projetos de .NET Framework

Importante

esta seção aplica-se somente a projetos .NET Framework.

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

  • argumentos de linha de comando para projetos de .NET Framework: os projetos de .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 .NET Framework.
  • páginas ASP.NET compiladas: .NET Framework projetos usam uma seção do arquivo web.config para compilar páginas. para o novo sistema de compilação e ASP.NET Core projetos, as opções são obtidas do arquivo de projeto.

a palavra para algumas opções de compilador alteradas de csc.exe e .NET Framework projetos para o novo sistema de MSBuild. A nova sintaxe é usada em toda esta seção. Ambas as versões são listadas na parte superior de cada página. Por csc.exe, todos os argumentos são listados seguindo 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 do seu arquivo executável (csc.exe) em um prompt de comando.

para projetos .NET Framework, você também pode executar csc.exe da linha de comando. Todas as opções do compilador estão disponíveis em duas formas: -option e /option. em projetos da web .NET Framework, você especifica opções para a compilação do código-behind no arquivo web.config . Para obter mais informações, consulte <compiler> elemento.

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

o arquivo executável csc.exe geralmente está localizado na pasta Microsoft. NET\Framework \ <Version> sob o diretório Windows . O local 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 Determinando qual versão do .NET Framework está instalada.