Параметры компилятора C#

В этом разделе описываются параметры, интерпретируемые компилятором C#. Параметры группируются в отдельные статьи на основе того, что они контролируют, например языковые функции, создание кода и выходные данные. Используйте оглавление для перехода между ними.

Настройка параметров

В проектах .NET можно задать два разных способа задания параметров компилятора:

• В файле *.csproj

  Свойства MSBuild можно добавить для любого параметра компилятора в файле *.csproj в формате XML. Имя свойства совпадает с параметром компилятора. Значение свойства задает значение параметра компилятора. Например, следующий фрагмент кода файла проекта задает LangVersion свойство.

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

  Дополнительные сведения о параметрах в файлах проекта см. в статье свойства MSBuild для проектов пакета SDK для .NET.

• Использование страниц свойств Visual Studio

  Visual Studio предоставляет страницы свойств для изменения свойств сборки. Дополнительные сведения о них см. в статье "Управление свойствами проекта и решения" — Windows или Управление свойствами проекта и решения — Mac.

Проекты .NET Framework

Помимо описанных выше механизмов можно задать параметры компилятора с помощью двух дополнительных методов для проектов .NET Framework:

• Аргументы командной строки для проектов .NET Framework: проекты .NET Framework используют csc.exe вместо dotnet build создания проектов. Аргументы командной строки можно указать дляcsc.exe для проектов .NET Framework.
• Скомпилированные ASP.NET страницы: проекты .NET Framework используют раздел файла web.config для компиляции страниц. Для новой системы сборки и проектов ASP.NET Core используются параметры из файла проекта.

Слово для некоторых параметров компилятора изменилось с csc.exe и проектов .NET Framework на новую систему MSBuild. Новый синтаксис используется в этом разделе. Обе версии перечислены в верхней части каждой страницы. Для csc.exeвсе аргументы перечислены после параметра и двоеточия. Например, -doc вариант будет следующим:

-doc:DocFile.xml

Компилятор C# можно вызвать, введя имя исполняемого файла (csc.exe) в командной строке.

Для проектов .NET Framework можно также запустить csc.exe из командной строки. Каждый параметр компилятора доступен в двух формах: -option и /option. В веб-проектах .NET Framework можно указать параметры компиляции кода в файлеweb.config . Дополнительные сведения см. в разделе <"Элемент компилятора>".

Если вы используете командную строку разработчика для Окна Visual Studio , все необходимые переменные среды задаются для вас. Сведения о том, как получить доступ к этому инструменту, см. в командной строке разработчика для Visual Studio.

Исполняемый файл csc.exe обычно находится в папке Microsoft.NET\Framework\<Version> в каталоге Windows . Его расположение может отличаться в зависимости от точной конфигурации определенного компьютера. Если на компьютере установлено несколько версий .NET Framework, вы найдете несколько версий этого файла. Дополнительные сведения о таких установках см. в статье "Практическое руководство. Определение версий платформы .NET Framework".