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

Страница Сборка в конструкторе проектов позволяет задать свойства конфигурации сборки. Эта страница относится только к проектам Visual C#.

Чтобы получить доступ к странице Сборка, выберите узел проекта (не узел Решение) в обозревателе решений. Затем выберите в меню Вид, Страницы свойств. После открытия конструктора проектов перейдите на вкладку Сборка.

Примечание.

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в этой статье. Возможно, вы используете другой выпуск Visual Studio или другие параметры среды. Дополнительные сведения см. в разделе Персонализация среды IDE.

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

Следующие параметры используются для выбора конфигурации и платформы с целью просмотра или внесения изменений.

Примечание.

Если выбраны упрощенные конфигурации сборки, система проекта определяет, следует ли выполнять построение отладочной или окончательной версии. Таким образом, эти параметры не отображаются. Дополнительные сведения см. в пошаговом руководстве по настройке конфигураций отладки и выпусков.

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

Указывает параметры конфигурации для отображения или изменения. Параметрами могут быть Активная (отладка) (используется по умолчанию), Отладка, Выпуск или Все конфигурации.

Платформа

Указывает параметры платформы для отображения или изменения. Значение по умолчанию — Активная (любой ЦП). Можно изменить активную платформу с помощью диспетчера конфигураций. Дополнительные сведения см. в разделе Практическое руководство. Создание и изменение конфигураций.

Общие

Описанные ниже параметры позволяют настроить несколько аспектов работы компилятора C#.

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

Указывает символы для условной компиляции. Разделяйте символы точкой с запятой (";"). Дополнительные сведения см. в разделе /define (параметры компилятора C#).

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

Определяет DEBUG в качестве символа во всех файлах исходного кода в приложении. Выбор этого элемента эквивалентен использованию параметра командной строки /define:DEBUG.

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

Определяет TRACE в качестве символа во всех файлах исходного кода в приложении. Выбор этого элемента эквивалентен использованию параметра командной строки /define:TRACE.

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

Указывает целевой процессор для выходного файла. Выберите x86 для любого 32-разрядного Intel-совместимого процессора, x64 для любого 64-разрядного Intel-совместимого процессора, ARM для процессоров ARM или Любой ЦП, чтобы указать, что приемлем любой процессор. Любой ЦП является значением по умолчанию для проектов, так как обеспечивает выполнение приложения на самом обширном спектре оборудования.

Дополнительные сведения см. в разделе /platform (параметры компилятора C#).

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

Указывает допускающий значение NULL контекст C# для всего проекта. Этот параметр пользовательского интерфейса появился в Visual Studio 16.5 и доступен только для проектов, использующих C# 8.0 или более поздней версии.

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

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

Если флажок Предпочитать 32-разрядную установлен, приложение выполняется как 32-разрядное в 32- и 64-разрядных версиях Windows. Если флажок снят, приложение выполняется как 32-разрядное в 32-разрядных версиях Windows и как 64-разрядное — в 64-разрядных версиях.

Если приложение запускается как 64-разрядное, размер указателя удваивается, и могут возникнуть проблемы совместимости с другими библиотеками, которые являются исключительно 32-разрядными. Запускать 64-разрядное приложение следует только в том случае, если ему требуется более 4 ГБ памяти либо 64-разрядные инструкции обеспечивают значительное повышение производительности.

Этот флажок доступен, только если верны все следующие условия:

  • На странице Сборка в списке Целевая платформа установлено значение Любой ЦП.

  • На странице Приложение в списке Тип вывода указано, что проект является приложением.

  • На странице Приложение в списке Целевая рабочая среда указана .NET Framework 4.5.

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

Разрешает компилировать код, в котором используется ключевое слово unsafe. Дополнительные сведения см. в разделе /unsafe (параметры компилятора C#).

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

Включение или отключение оптимизации кода компилятором делает код более быстрым, коротким и эффективным. Дополнительные сведения см. в разделе /optimize (параметры компилятора C#).

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

Приведенные ниже параметры позволяют настроить ошибки и предупреждения для процесса сборки.

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

Указывает уровень предупреждений, выводимых компилятором. Дополнительные сведения см. в разделе /warn (параметры компилятора C#).

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

Отключает возможность компилятора создавать предупреждения. Разделяйте предупреждения запятой или точкой с запятой. Дополнительные сведения см. в разделе /nowarn (параметры компилятора C#).

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

Приведенные ниже параметры используются для указания предупреждений, которые обрабатываются как ошибки. Выберите один из следующих параметров, чтобы указать, при каких условиях следует возвращать ошибку при возникновении предупреждения в сборке. Дополнительные сведения см. в разделе /warnaserror (параметры компилятора C#).

Нет — не обрабатывает предупреждения как ошибки.

Все — обрабатывает все предупреждения как ошибки.

Конкретные предупреждения — обрабатывает указанные предупреждения как ошибки. Разделяйте предупреждения запятой или точкой с запятой.

Совет

Если вы не хотите, чтобы предупреждения анализа кода обрабатывались как ошибки, см. раздел Вопросы и ответы по анализу кода.

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

Приведенные ниже параметры позволяют настроить вывод данных для процесса сборки.

Путь вывода

Местоположение выходных файлов для конфигурации этого проекта. Введите путь к выходной папке сборки в этом поле или нажмите кнопку Обзор, чтобы указать путь. Путь является относительным. Если ввести абсолютный путь, он будет сохранен как относительный. Путь по умолчанию — bin\Debug или bin\Release\.

Если выбраны упрощенные конфигурации сборки, система проекта определяет, следует ли выполнять построение отладочной или окончательной версии. Команда Сборка из меню Отладка (F5) перемещает сборку в расположение отладки вне зависимости от заданного значения Путь для создаваемых файлов. Однако команда Сборка в меню Сборка позволяет поместить сборку в указанное расположение. Дополнительные сведения см. в разделе Общие сведения о конфигурациях построения.

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

Указывает имя файла, в который в результате обработки записываются комментарии к документации. Дополнительные сведения см. в разделе /doc (параметры компилятора C#).

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

Указывает, что ваше управляемое приложение предоставляет COM-объект (вызываемую оболочку COM), чтобы COM-объект мог взаимодействовать с управляемым приложением. Свойству Тип вывода на странице Приложениеконструктора проектов для этого приложения следует задать значение Библиотеки классов, чтобы было доступно свойство Регистрация для COM-взаимодействия. Пример класса, который можно включить в приложение Visual C# и предоставить в качестве COM-объекта, см. в примере класса COM.

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

Указывает, будет ли компилятор использовать инструмент создания XML-сериализатора (Sgen.exe) для создания сборок XML-сериализации. Сборки сериализации могут повысить производительность при запуске XmlSerializer, если вы использовали этот класс для сериализации типов в коде. По умолчанию этот параметр имеет значение Автоматически, которое указывает, что сборки сериализации будут создаваться только в том случае, если вы использовали XmlSerializer для кодирования типов в XML-код. Отключено указывает, что сборки сериализации никогда не создаются, независимо от того, используется ли в вашем коде XmlSerializer. Включено указывает, что сборки сериализации создаются всегда. Сборкам сериализации присваиваются имена TypeName.XmlSerializers.dll. Дополнительные сведения см. в статье Инструмент создания XML-сериализатора (Sgen.exe).

Расширенные

Щелкните для отображения диалогового окна Диалоговое окно "Дополнительные параметры компилятора" (C#).

См. также