Параметры компилятора 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 , а не для сборки проектов. Аргументы командной строки можно указать в 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 можно запустить из командной строки. Каждый параметр компилятора можно использовать в двух формах записи: -параметр или /параметр. В проектах .NET Framework параметры для компиляции кода программной части указываются в файле web.config. Дополнительные сведения см. в разделе элемент компилятора >.

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

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