Параметры компилятора C#, упорядоченные по категориямC# Compiler Options Listed by Category

Следующие параметры компилятора упорядочены по категории.The following compiler options are sorted by category. Алфавитный список см. в разделе Параметры компилятора C# в алфавитном порядке.For an alphabetical list, see C# Compiler Options Listed Alphabetically.

OptimizationOptimization

ПараметрOption НазначениеPurpose
-filealign-filealign Задает размер разделов в выходном файле.Specifies the size of sections in the output file.
-optimize-optimize Включает или отключает оптимизацию.Enables/disables optimizations.

Выходные файлыOutput Files

ПараметрOption НазначениеPurpose
-deterministic-deterministic Указывает компилятору на необходимость вывода сборки, чье двоичное содержимое идентично в разных компиляциях, если входные данные идентичны.Causes the compiler to output an assembly whose binary content is identical across compilations if inputs are identical.
-doc-doc Задает XML-файл, куда должны записываться обработанные комментарии к документации.Specifies an XML file where processed documentation comments are to be written.
-out-out Задает выходной файл.Specifies the output file.
-pathmap-pathmap Указание сопоставления для вывода компилятором имен исходных путей.Specify a mapping for source path names output by the compiler
/pdb-pdb Указывает имя и расположение PDB-файла.Specifies the file name and location of the .pdb file.
-platform-platform Укажите выходную платформу.Specify the output platform.
/preferreduilang-preferreduilang Укажите язык для выходных данных компилятора.Specify a language for compiler output.
/refout-refout Создание ссылочной сборки в дополнение к основной.Generate a reference assembly in addition to the primary assembly.
/refonly-refonly Создание ссылочной сборки вместо основной.Generate a reference assembly instead of a primary assembly.
-target-target Задает формат выходного файла, используя один из пяти параметров: -target:appcontainerexe, -target:exe, -target:library, -target:module, -target:winexe или -target:winmdobj.Specifies the format of the output file using one of five options: -target:appcontainerexe, -target:exe, -target:library, -target:module, -target:winexe, or -target:winmdobj.
-modulename:<строка>-modulename:<string> Укажите имя исходного модуля.Specify the name of the source module

Сборки .NET Framework.NET Framework Assemblies

ПараметрOption НазначениеPurpose
-addmodule-addmodule Задает один или несколько модулей, которые должны быть частью этой сборки.Specifies one or more modules to be part of this assembly.
-delaysign-delaysign Указывает компилятору добавить открытый ключ, но оставить сборку без подписи.Instructs the compiler to add the public key but to leave the assembly unsigned.
-keycontainer-keycontainer Задает имя контейнера криптографического ключа.Specifies the name of the cryptographic key container.
-keyfile-keyfile Задает имя файла, содержащего криптографический ключ.Specifies the filename containing the cryptographic key.
/lib-lib Задает расположение сборок, указанных с помощью параметра -reference.Specifies the location of assemblies referenced by means of -reference.
-nostdlib-nostdlib Указывает компилятору не импортировать стандартную библиотеку (mscorlib.dll).Instructs the compiler not to import the standard library (mscorlib.dll).
-publicsign-publicsign Применение открытого ключа без подписи сборки. При этом в сборке устанавливается бит, указывающий на то, что она подписана.Apply a public key without signing the assembly, but set the bit in the assembly indicating the assembly is signed.
-reference-reference Импортирует метаданные из файла, содержащего сборку.Imports metadata from a file that contains an assembly.
-analyzer-analyzer Запускает анализаторы из этой сборки (краткая форма: /a)Run the analyzers from this assembly (Short form: /a)
-additionalfile-additionalfile Имена дополнительных файлов, которые непосредственно не влияют на создание кода, но могут использоваться анализаторами для выдачи ошибок или предупреждений.Names additional files that don't directly affect code generation but may be used by analyzers for producing errors or warnings.
-embed-embed Внедрение всех исходных файлов в PDB-файл.Embed all source files in the PDB.
-embed:<список_файлов>-embed:<file list> Внедрение определенных файлов в PDB-файл.Embed specific files in the PDB.

Отладка и проверка на ошибкиDebugging/Error Checking

ПараметрOption НазначениеPurpose
-bugreport-bugreport Создает файл, содержащий сведения, позволяющие легко создать отчет об ошибке.Creates a file that contains information that makes it easy to report a bug.
/checked-checked Указывает, будут ли целочисленные арифметические операции, переполняющие границы типа данных, вызывать исключение во время выполнения.Specifies whether integer arithmetic that overflows the bounds of the data type will cause an exception at run time.
-debug-debug Указывает компилятору выдавать отладочные сведения.Instruct the compiler to emit debugging information.
-errorreport-errorreport Устанавливает поведение отчетов об ошибках.Sets error reporting behavior.
/fullpaths-fullpaths Задает абсолютный путь к файлу в выходных данных компилятора.Specifies the absolute path to the file in compiler output.
-nowarn-nowarn Подавляет создание компилятором указанных предупреждений.Suppresses the compiler's generation of specified warnings.
/warn-warn Устанавливает уровень предупреждений.Sets the warning level.
-warnaserror-warnaserror Приравнивает предупреждения к ошибкам.Promotes warnings to errors.
-ruleset:<файл>-ruleset:<file> Укажите файл набора правил, который отключает определенные диагностики.Specify a ruleset file that disables specific diagnostics.

ПрепроцессорPreprocessor

ПараметрOption НазначениеPurpose
-define-define Определяет символы препроцессора.Defines preprocessor symbols.

РесурсыResources

ПараметрOption НазначениеPurpose
-link-link Делает сведения о типах COM в указанных сборках доступными для проекта.Makes COM type information in specified assemblies available to the project.
-linkresource-linkresource Создает ссылку на управляемый ресурс.Creates a link to a managed resource.
-resource-resource Внедряет ресурс .NET Framework в выходной файл.Embeds a .NET Framework resource into the output file.
-win32icon-win32icon Указывает ICO-файл для вставки в выходной файл.Specifies an .ico file to insert into the output file.
/win32res:-win32res Задает ресурс Win32 для вставки в выходной файл.Specifies a Win32 resource to insert into the output file.

ПрочееMiscellaneous

ПараметрOption НазначениеPurpose
@ Указывает файл ответа.Specifies a response file.
-?-? Перечисляет параметры компилятора в stdout.Lists compiler options to stdout.
-baseaddress-baseaddress Указывает предпочтительный базовый адрес для загрузки DLL.Specifies the preferred base address at which to load a DLL.
-codepage-codepage Задает кодовую страницу, которая будет использоваться для всех файлов исходного кода при компиляции.Specifies the code page to use for all source code files in the compilation.
-help-help Перечисляет параметры компилятора в stdout.Lists compiler options to stdout.
-highentropyva-highentropyva Указывает, что исполняемый файл поддерживает технологию Address Space Layout Randomization (ASLR).Specifies that the executable file supports address space layout randomization (ASLR).
-langversion-langversion Указание языковой версии: Default, ISO-1, ISO-2, 3, 4, 5, 6, 7, 7.1, 7.2, 7.3 или Latest.Specify language version: Default, ISO-1, ISO-2, 3, 4, 5, 6, 7, 7.1, 7.2, 7.3, or Latest
-main-main Указывает местоположение метода Main.Specifies the location of the Main method.
-noconfig-noconfig Предписывает компилятору не компилировать csc.rsp.Instructs the compiler not to compile with csc.rsp.
-nologo-nologo Подавляет сведения баннера компилятора.Suppresses compiler banner information.
-recurse-recurse Выполняет поиск в подкаталогах исходных файлов для компиляции.Searches subdirectories for source files to compile.
-subsystemversion-subsystemversion Задает минимальную версию подсистемы, которую может использовать исполняемый файл.Specifies the minimum version of the subsystem that the executable file can use.
/unsafe-unsafe Разрешает компиляцию кода, использующего ключевое слово unsafe.Enables compilation of code that uses the unsafe keyword.
-utf8output-utf8output Отображает выходные данные компилятора в кодировке UTF-8.Displays compiler output using UTF-8 encoding.
-parallel[+|-]-parallel[+|-] Указывает, следует ли использовать параллельную сборку (+).Specifies whether to use concurrent build (+).
-checksumalgorithm:<алгоритм>-checksumalgorithm:<alg> Указывает алгоритм для расчета контрольной суммы файла источника, хранящегося в PDB.Specify the algorithm for calculating the source file checksum stored in PDB. Поддерживаемые значения: SHA1 (по умолчанию) или SHA256.Supported values are: SHA1 (default) or SHA256.
Из-за конфликта с SHA1 корпорация Майкрософт рекомендует использовать SHA256.Due to collision problems with SHA1, Microsoft recommends SHA256.

Устаревшие параметрыObsolete Options

ПараметрOption НазначениеPurpose
-incremental-incremental Включает инкрементную компиляцию.Enables incremental compilation.

См. также разделSee also