Страница "Построение" в конструкторе проектов (C#)Build Page, Project Designer (C#)

Страница Сборка в конструкторе проектов позволяет задать свойства конфигурации сборки.Use the Build page of the Project Designer to specify the project's build configuration properties. Эта страница применяется только к проектам Visual C#Visual C#.This page applies to Visual C#Visual C# projects only.

Чтобы получить доступ к странице Сборка, выберите узел проекта (не узел Решение) в обозревателе решений.To access the Build page, choose a project node (not the Solution node) in Solution Explorer. Затем выберите в меню Вид, Страницы свойств.Then choose View, Property Pages on the menu. После открытия конструктора проектов перейдите на вкладку Сборка.When the Project Designer appears, choose the Build tab.

Примечание

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в этой статье.Your computer might show different names or locations for some of the Visual Studio user interface elements in this article. Возможно, вы используете другой выпуск Visual Studio или другие параметры среды.You may be using a different edition of Visual Studio or different environment settings. Дополнительные сведения см. в разделе Персонализация среды IDE.For more information, see Personalize the IDE.

Конфигурация и платформаConfiguration and Platform

Следующие параметры используются для выбора конфигурации и платформы с целью просмотра или внесения изменений.The following options enable you to select the configuration and platform to display or modify.

Примечание

Если выбраны упрощенные конфигурации сборки, система проекта определяет, следует ли выполнять построение отладочной или окончательной версии.With simplified build configurations, the project system determines whether to build a debug or release version. Таким образом, эти параметры не отображаются.Therefore, these options are not displayed. Дополнительные сведения см. в пошаговом руководстве по настройке конфигураций отладки и выпусков.For more information, see How to: Set debug and release configurations.

КонфигурацияConfiguration

Указывает параметры конфигурации для отображения или изменения.Specifies which configuration settings to display or modify. Параметрами могут быть Активная (отладка) (используется по умолчанию), Отладка, Выпуск или Все конфигурации.The settings can be Active (Debug) (this is the default), Debug, Release, or All Configurations.

ПлатформаPlatform

Указывает параметры платформы для отображения или изменения.Specifies which platform settings to display or modify. Значение по умолчанию — Активная (любой ЦП) .The default setting is Active (Any CPU). Можно изменить активную платформу с помощью диспетчера конфигураций.You can change the active platform using the Configuration Manager. Дополнительные сведения см. в разделе Практическое руководство. Создание и изменение конфигураций.For more information, see How to: Create and Edit Configurations.

Общие сведенияGeneral

Описанные ниже параметры позволяют настроить несколько аспектов работы компилятора C#.The following options enable you to configure several C# compiler settings.

Символы условной компиляцииConditional compilation symbols

Указывает символы для условной компиляции.Specifies symbols on which to perform conditional compilation. Разделяйте символы точкой с запятой (";").Separate symbols with a semi-colon (";"). Дополнительные сведения см. в разделе /define (параметры компилятора C#).For more information, see /define (C# Compiler Options).

Определить константу DEBUGDefine DEBUG constant

Определяет DEBUG в качестве символа во всех файлах исходного кода в приложении.Defines DEBUG as a symbol in all source code files in your app. Выбор этого элемента эквивалентен использованию параметра командной строки /define:DEBUG.Selecting this is equivalent to using the /define:DEBUG command-line option.

Определить константу TRACEDefine TRACE constant

Определяет TRACE в качестве символа во всех файлах исходного кода в приложении.Defines TRACE as a symbol in all source code files in your app. Выбор этого элемента эквивалентен использованию параметра командной строки /define:TRACE.Selecting this is equivalent to using the /define:TRACE command-line option.

Целевая платформаPlatform Target

Указывает целевой процессор для выходного файла.Specifies the processor to be targeted by the output file. Выберите x86 для любого 32-разрядного Intel-совместимого процессора, x64 для любого 64-разрядного Intel-совместимого процессора, ARM для процессоров ARM или Любой ЦП, чтобы указать, что приемлем любой процессор.Choose x86 for any 32-bit Intel-compatible processor, choose x64 for any 64-bit Intel-compatible processor, choose ARM for ARM processors, or choose Any CPU to specify that any processor is acceptable. Любой ЦП является значением по умолчанию для проектов, так как обеспечивает выполнение приложения на самом обширном спектре оборудования.Any CPU is the default value for projects, because it allows the application to run on the broadest range of hardware.

Дополнительные сведения см. в разделе /platform (параметры компилятора C#).For more information, see /platform (C# Compiler Options).

Допускает значения NULLNullable

Указывает допускающий значение NULL контекст C# для всего проекта.Specifies the project-wide C# nullable context. Этот параметр пользовательского интерфейса появился в Visual Studio 16.5 и доступен только для проектов, использующих C# 8.0 или более поздней версии.This UI option was introduced in Visual Studio 16.5, and is only enabled for projects that use C# 8.0 or later.

Дополнительные сведения см. в разделе Контексты, допускающие значения NULL.For more information, see Nullable Contexts.

Предпочитать 32-разряднуюPrefer 32-bit

Если флажок Предпочитать 32-разрядную установлен, приложение выполняется как 32-разрядное в 32- и 64-разрядных версиях Windows.If the Prefer32-bit check box is selected, the application runs as a 32-bit application on both 32-bit and 64-bit versions of Windows. Если флажок снят, приложение выполняется как 32-разрядное в 32-разрядных версиях Windows и как 64-разрядное — в 64-разрядных версиях.If the check box is cleared, the application runs as a 32-bit application on 32-bit versions of Windows and as a 64-bit application on 64-bit versions of Windows.

Если приложение запускается как 64-разрядное, размер указателя удваивается, и могут возникнуть проблемы совместимости с другими библиотеками, которые являются исключительно 32-разрядными.If you run an application as a 64-bit application, the pointer size doubles, and compatibility problems can occur with other libraries that are exclusively 32-bit. Запускать 64-разрядное приложение следует только в том случае, если ему требуется более 4 ГБ памяти либо 64-разрядные инструкции обеспечивают значительное повышение производительности.It is useful to run a 64-bit application only if it needs more than 4 GB of memory or 64-bit instructions provide a significant performance improvement.

Этот флажок доступен, только если верны все следующие условия:This check box is available only if all of the following conditions are true:

  • На странице Сборка в списке Целевая платформа установлено значение Любой ЦП.On the Build Page, the Platform target list is set to Any CPU.

  • На странице Приложение в списке Тип вывода указано, что проект является приложением.On the Application Page, the Output type list specifies that the project is an application.

  • На странице Приложение в списке Целевая рабочая среда указана .NET Framework 4.5.On the Application Page, the Target framework list specifies the .NET Framework 4.5.

Разрешить небезопасный кодAllow unsafe code

Разрешает компилировать код, в котором используется ключевое слово unsafe.Allows code that uses the unsafe keyword to compile. Дополнительные сведения см. в разделе /unsafe (параметры компилятора C#).For more information, see /unsafe (C# Compiler Options).

Оптимизировать кодOptimize code

Включение или отключение оптимизации кода компилятором делает код более быстрым, коротким и эффективным.Enable or disable optimizations performed by the compiler to make your output file smaller, faster, and more efficient. Дополнительные сведения см. в разделе /optimize (параметры компилятора C#).For more information, see /optimize (C# Compiler Options).

Ошибки и предупрежденияErrors and Warnings

Приведенные ниже параметры позволяют настроить ошибки и предупреждения для процесса сборки.The following settings are used to configure the error and warning options for the build process.

Уровень предупрежденийWarning level

Указывает уровень предупреждений, выводимых компилятором.Specifies the level to display for compiler warnings. Дополнительные сведения см. в разделе /warn (параметры компилятора C#).For more information, see /warn (C# Compiler Options).

Отключить предупрежденияSuppress warnings

Отключает возможность компилятора создавать предупреждения.Blocks the compiler's ability to generate one or more warnings. Разделяйте предупреждения запятой или точкой с запятой.Separate multiple warning numbers with a comma or semicolon. Дополнительные сведения см. в разделе /nowarn (параметры компилятора C#).For more information, see /nowarn (C# Compiler Options).

Обрабатывать предупреждения как ошибкиTreat Warnings as Errors

Приведенные ниже параметры используются для указания предупреждений, которые обрабатываются как ошибки.The following settings are used to specify which warnings are treated as errors. Выберите один из следующих параметров, чтобы указать, при каких условиях следует возвращать ошибку при возникновении предупреждения в сборке.Select one of the following options to indicate under what conditions to return an error when the build encounters a warning. Дополнительные сведения см. в разделе /warnaserror (параметры компилятора C#).For more information, see /warnaserror (C# Compiler Options).

Нет — не обрабатывает предупреждения как ошибки.None - Treats no warnings as errors.

Все — обрабатывает все предупреждения как ошибки.All - Treats all warnings as errors.

Конкретные предупреждения — обрабатывает указанные предупреждения как ошибки.Specific warnings - Treats the specified warnings as errors. Разделяйте предупреждения запятой или точкой с запятой.Separate multiple warning numbers with a comma or semicolon.

Совет

Если вы не хотите, чтобы предупреждения анализа кода обрабатывались как ошибки, см. раздел Вопросы и ответы по анализу кода.If you don't want code analysis warnings to be treated as errors, see Code analysis FAQ.

Выходные данныеOutput

Приведенные ниже параметры позволяют настроить вывод данных для процесса сборки.The following settings are used to configure the output options for the build process.

Путь выводаOutput path

Местоположение выходных файлов для конфигурации этого проекта.Specifies the location of the output files for this project's configuration. Введите путь к выходной папке сборки в этом поле или нажмите кнопку Обзор, чтобы указать путь.Enter the path of the build output in this box, or choose the Browse button to specify a path. Путь является относительным. Если ввести абсолютный путь, он будет сохранен как относительный.The path is relative; if you enter an absolute path, it will be saved as relative. Путь по умолчанию — bin\Debug или bin\Release\.The default path is bin\Debug or bin\Release\.

Если выбраны упрощенные конфигурации сборки, система проекта определяет, следует ли выполнять построение отладочной или окончательной версии.With simplified build configurations, the project system determines whether to build a debug or release version. Команда Сборка из меню Отладка (F5) перемещает сборку в расположение отладки вне зависимости от заданного значения Путь для создаваемых файлов.The Build command from the Debug menu (F5) will put the build in the debug location regardless of the Output path you specify. Однако команда Сборка в меню Сборка позволяет поместить сборку в указанное расположение.However, the Build command from the Build menu puts it in the location you specify. Дополнительные сведения см. в разделе Общие сведения о конфигурациях построения.For more information, see Understanding Build Configurations.

XML-файл документацииXML documentation file

Указывает имя файла, в который в результате обработки записываются комментарии к документации.Specifies the name of a file into which documentation comments will be processed. Дополнительные сведения см. в разделе /doc (параметры компилятора C#).For more information, see /doc (C# Compiler Options).

Регистрация для COM-взаимодействияRegister for COM interop

Указывает, что ваше управляемое приложение предоставляет COM-объект (вызываемую оболочку COM), чтобы COM-объект мог взаимодействовать с управляемым приложением.Indicates that your managed application will expose a COM object (a COM callable wrapper) that allows a COM object to interact with your managed application. Свойству Тип вывода на странице Приложениеконструктора проектов для этого приложения следует задать значение Библиотеки классов, чтобы было доступно свойство Регистрация для COM-взаимодействия.The Output type property in the Application page of the Project Designer for this application must be set to Class Library in order for the Register for COM interop property to be available. Пример класса, который можно включить в приложение Visual C#Visual C# и предоставлять в виде COM-объекта, см. в разделе Пример COM-класса.For an example class that you might include in your Visual C#Visual C# application and expose as a COM object, see Example COM Class.

Создание сборки сериализацииGenerate serialization assembly

Указывает, будет ли компилятор использовать инструмент создания XML-сериализатора (Sgen.exe) для создания сборок XML-сериализации.Specifies whether the compiler will use the XML Serializer Generator Tool (Sgen.exe) to create XML serialization assemblies. Сборки сериализации могут повысить производительность при запуске XmlSerializer, если вы использовали этот класс для сериализации типов в коде.Serialization assemblies can improve the startup performance of XmlSerializer if you have used that class to serialize types in your code. По умолчанию этот параметр имеет значение Автоматически, которое указывает, что сборки сериализации будут создаваться только в том случае, если вы использовали XmlSerializer для кодирования типов в XML-код.By default, this option is set to Auto, which specifies that serialization assemblies be generated only if you have used XmlSerializer to encode types in your code to XML. Отключено указывает, что сборки сериализации никогда не создаются, независимо от того, используется ли в вашем коде XmlSerializer.Off specifies that serialization assemblies never be generated, regardless of whether your code uses XmlSerializer. Включено указывает, что сборки сериализации создаются всегда.On specifies that serialization assemblies always be generated. Сборкам сериализации присваиваются имена TypeName.XmlSerializers.dll.Serialization assemblies are named TypeName.XmlSerializers.dll. Дополнительные сведения см. в статье Инструмент создания XML-сериализатора (Sgen.exe).For more information, see XML Serializer Generator Tool (Sgen.exe).

ДополнительноAdvanced

Щелкните для отображения диалогового окна Диалоговое окно "Дополнительные параметры компилятора" (C#).Click to display the Advanced Build Settings Dialog Box (C#) dialog box.

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