Конструктор проектов .NET (C#)

Используйте конструктор проектов, чтобы указать параметры и свойства проекта для .NET Core и .NET 5+. Сведения о проектах платформа .NET Framework и Visual Basic см. в разделе "Что такое конструктор проектов .NET?".

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

Примечание.

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

Приложения, общие параметры

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

Тип выходных данных

Тип приложения для сборки. Значения различаются в зависимости от типа проекта. Например, для проекта Консольное приложение можно указать Приложение Windows, Консольное приложение или Библиотека классов в качестве типа выходных данных.

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

Дополнительные сведения о программном доступе к этому свойству см. в разделе OutputType.

Целевая рабочая среда

Определяет версию платформы .NET, для которой предназначено приложение. Этот параметр может иметь разные значения в зависимости от того, какие версии .NET установлены на компьютере.

Для проекта, предназначенного для .NET Core или .NET 5+, доступные версии могут отображаться следующим образом:

Примечание.

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

Дополнительные сведения см. в статье Общие сведения о настройке для платформы.

Целевая ОС

Указывает операционную систему, предназначенную для проекта. В сочетании с целевой платформой это создает .NET 5+ TF.

Автоматически запускаемый объект

Определяет точку входа, вызываемую при загрузке приложения. Как правило, в качестве точки входа назначается либо главная форма в приложении, либо процедура Main, которая должна выполняться при запуске приложения. Так как библиотеки классов не имеют точки входа, для них возможно только одно значение этого свойства — (Не задано).

Для проектов приложений WPF этот параметр по умолчанию имеет значение (Не задано). Другой параметр — [имя_проекта].App. В проектах WPF необходимо указать начальный универсальный код ресурса (URI) для загрузки ресурса пользовательского интерфейса при запуске приложения. Для этого откройте файл Application.xaml проекта и присвойте свойству StartupUri имя XAML-файла проекта, например Window1.xaml. Список допустимых корневых элементов см. в разделе StartupUri. Необходимо также определить метод public static void Main() в классе проекта. Этот класс будет отображаться в списке Автоматически запускаемый объект в виде имя_проекта.имя_класса. Затем класс можно выбрать в качестве автоматически запускаемого объекта.

Дополнительные сведения см. в разделе /main (параметры компилятора C#). Для программного доступа к этому свойству см. раздел StartupObject.

Имя сборки

Определяет имя выходного файла, который будет содержать манифест сборки. Изменение этого свойства повлечет за собой изменение свойства Имя выходных данных.

Это изменение также можно произвести в командной строке с помощью параметра /out (параметры компилятора C#).

Для программного доступа к этому свойству см. раздел AssemblyName.

Пространство имен по умолчанию

Определяет базовое пространство имен для файлов, добавляемых в проект.

Дополнительные сведения о создании пространств имен в коде см. в разделе namespace.

Для программного доступа к этому свойству см. раздел RootNamespace.

Параметры приложений, ресурсов Win32

Значок

Задает ICO-файл для использования в качестве значка программы. Нажмите кнопку Просмотреть для выбора имеющегося графического файла или введите имя нужного файла. Дополнительные сведения см. в разделе /win32icon (параметры компилятора C#).

Для программного доступа к этому свойству см. раздел ApplicationIcon.

Сведения о создании значка см. в статье Редактор изображений для значков.

Ресурсы

Параметр "Ресурсы" помогает настроить параметры ресурсов для приложения. По умолчанию включены параметры значка и манифеста. Это позволяет выбирать собственный значок и различные параметры создания манифеста. Оставьте переключатель в этом положении, если проект не содержит файла ресурсов.

Если выбрать файл ресурса, настройте файл ресурса для проекта. Введите имя пути или нажмите кнопку "Обзор ", чтобы добавить в проект файл ресурсов Win32. Дополнительные сведения см. в статье Создание файлов ресурсов для приложений .NET.

Манифест

Позволяет выбрать способ создания манифеста при запуске приложения в Windows с включенным контролем учетных записей. Этот параметр может принимать следующие значения:

• Внедрить манифест с настройками по умолчанию. Поддерживает стандартный режим работы Visual Studio в Windows, предполагающий внедрение информации о безопасности в исполняемый файл приложения, причем requestedExecutionLevel имеет значение AsInvoker. Этот параметр по умолчанию.

• Создать приложение без манифеста. Этот метод также называют виртуализацией. Используйте этот вариант для обеспечения совместимости с более старыми приложениями.

• Используйте настраиваемый манифест. Позволяет ввести путь или перейти к пользовательскому манифесту проекта.

Глобальные параметры использования

Неявные глобальные использование

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

Управление неявными глобальными использованием

Вручную добавьте и удалите глобальные использование для использования в проектах.

Сборка, общие параметры

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

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

Отладка пользовательских символов

Задает символы условной компиляции для отладочных сборок. Символы отладки по умолчанию отображаются в строке, разделенной точкой с запятой.

Выпуск пользовательских символов

Задает символы условной компиляции для сборок выпуска. Символы выпуска по умолчанию отображаются в строке, разделенной точкой с запятой.

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

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

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

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

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

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

Создание сведений о сборке

Указывает, преобразуются ли свойства проекта, связанные с пакетом, в атрибуты сборки. Дополнительные сведения см. в свойстве GenerateAssemblyInfo .

Небезопасный код

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

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

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

Отладочные символы

Определяет тип отладочной информации, создаваемой компилятором. Сведения о настройке производительности отладки приложения см . в разделе "Параметр компилятора DebugType ". Эта настройка имеет следующие параметры:

• none

  Указывает, что отладочная информация создаваться не будет.

• full

  Позволяет подключить отладчик к выполняющейся программе.

• pdbonly

  Разрешает отладку исходного кода при запуске программы в отладчике, но при этом ассемблерный код отображается только при подключении исполняемой программы к отладчику.

• portable

  Создает не зависящий от платформы PDB-файл, который предоставляет другим инструментам, особенно отладчикам, сведения о том, что содержится в основном исполняемом файле и как он был создан. Дополнительные сведения см. в статье Portable PDB.

• embedded

  Внедряет сведения переносимого файла символов в сборку. Внешний PDB-файл не создается.

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

Параметры сборки, ошибок и предупреждений

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

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

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

Подавление определенных предупреждений

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

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

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

Обработку определенных предупреждений как ошибок

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

Совет

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

Сборка, параметры вывода

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

Базовый выходной путь

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

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

Эталонная сборка

Указывает, следует ли создавать эталонную сборку, содержащую общедоступный API проекта.

Файл документации

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

Сборка, параметры событий

Сведения о параметрах событий сборки см. в разделе "Указание событий сборки" (C#).

Сборка, публикация параметров

Публикация

Позволяет запускать целевой объект публикации MSBuild. Дополнительные сведения см. в свойстве MSBuild IsPublishable .

Публикация обрезана

Указывает, включена ли обрезка во время процесса публикации. Дополнительные сведения см. в разделе "Свойства, связанные с обрезкой".

Публикация собственного AOT

Указывает, следует ли создавать приложение, автономное и скомпилированное в машинном коде. Дополнительные сведения см. в статье о развертывании AOT в машинном коде.

Сборка, строгие параметры именования

Подписывая сборку

Установите этот флажок, чтобы подписать сборку и создать файл ключа со строгим именем. Дополнительные сведения о подписи сборки с помощью конструктора проектов см. в разделе Практическое руководство. Подписывание сборки (Visual Studio). Подробнее см. в разделе Сборки со строгими именами.

Для подписывания сборки этот параметр использует средство Al.exe из Windows Software Development Kit (пакет SDK). Дополнительные сведения о Al.exe см. в разделе Практическое руководство. Подписание сборки строгим именем.

Список файлов ключей строгого имени

Позволяет указать новый или существующий файл ключа со строгим именем, используемый для подписания сборки. Нажмите кнопку <"Обзор",> чтобы выбрать существующий файл ключа.

Только знак задержки

Установите этот флажок, чтобы включить отложенную подпись. Дополнительные сведения см. в разделе Отложенная подпись сборки.

В случае отложенной подписи проект нельзя выполнить или отладить. Однако можно использовать Sn.exe (программа Strong Name) с параметром -Vr, чтобы пропустить проверку во время разработки.

Примечание.

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

Сборка, дополнительные параметры

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

Версия языка

Связан с параметром /langversion (параметры компилятора C#), который указывает, как выбирается версия языка по умолчанию на основе целевой платформы проекта.

Проверка арифметического переполнения

Указывает, вызывает ли исключение во время выполнения целочисленный арифметический оператор, не относящийся к области ключевых слов checked или unchecked, значение которого лежит вне диапазона типа данных. Дополнительные сведения см. в разделе /checked (параметры компилятора C#).

Детерминированное

Указывает, следует ли создавать выходные данные байтов для байтов из одного источника входных данных. Дополнительные сведения см. в разделе "Параметры компилятора C#", управляющие созданием кода.

Отчеты об ошибках внутреннего компилятора

Указывает, следует ли сообщать об ошибках компилятора в корпорацию Майкрософт. Если задано значение запрашивать (по умолчанию), при внутренней ошибке компилятора вы получите запрос, позволяющий отправить корпорации Майкрософт отчет в электронном виде. Если задано значение отправить, отчет об ошибке будет отправляться автоматически. Если задано значение очередь, отчеты об ошибках будут помещаться в очередь. Если задано значение нет, отчет об ошибке выводится только в выходных данных компилятора. Дополнительные сведения см. в разделе /errorreport (параметры компилятора C#).

Выравнивание файла

Задает размер разделов в выходном файле. Допустимые значения: 512, 1024, 2048, 4096 и 8192. Эти значения измеряются в байтах. Каждый раздел выравнивается по границе, кратной этому значению, что влияет на размер выходного файла. Дополнительные сведения см. в разделе /filealign (параметры компилятора C#).

Пакеты, общие параметры

Свойства в этом разделе используются для настройки пакетов, как правило, соответствующих свойствам в nuGet.nuspec-файле. Дополнительные сведения см . в nuspec-файле.

Параметры пакета, лицензии

Лицензия на пакет

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

Пакеты, параметры символов

Создание пакета символов

Указывает, следует ли создавать пакет символов для отладки. Дополнительные сведения см. в разделе "Создание пакетов символов " (SNUPKG)".

Анализ кода, все параметры анализатора

Запуск в сборке

Указывает, следует ли выполнять анализ исходного кода при сборке проекта. Дополнительные сведения см. в разделе "Отключение анализа исходного кода для .NET".

Запуск в динамическом анализе

Указывает, следует ли выполнять динамический анализ исходного кода при сборке проекта. Дополнительные сведения см. в разделе "Отключение анализа исходного кода для .NET".

Анализ кода, параметры анализатора .NET

Принудительное применение стиля кода при сборке

Указывает, сообщаются ли нарушения стиля кода .NET при создании проекта. Дополнительные сведения см. в разделе "Применение стилей кода в сборке".

Включение анализаторов .NET

Включает или отключает анализаторы платформы компилятора .NET (Roslyn). Дополнительные сведения см. в статье "Включение или установка сторонних анализаторов .NET".

Уровень анализа

Задает набор анализаторов, выполняемых в проекте. Дополнительные сведения см . в разделе "Последние обновления " в статье об анализе кода.

Отладка, общие параметры

Выберите ссылку, чтобы открыть пользовательский интерфейс профилей запуска отладки. Этот пользовательский интерфейс позволяет добавлять и настраивать различные профили для использования при отладке. Каждое имя профиля отображается как параметр запуска в списке начальной отладки .

Для проектов ASP.NET Core параметры в пользовательском интерфейсе профилей запуска соответствуют параметрам в файле запуска проекта Параметры.json. Подробные сведения о том, как этот файл используется в ASP.NET разработке, см. в разделе "Разработка и запуск Параметры.json".

Ресурсы, общие параметры

Выберите ссылку, чтобы открыть файл ресурсов сборки RESX. Дополнительные сведения см. на странице Параметры конструктора проектов.

См. также

Обновленный интерфейс свойств проекта