Конструктор проектов .NET

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

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

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

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

тип вывода

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

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

Сведения о программном доступе к этому свойству см. в OutputType.

Целевая структура

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

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

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

целевая ОС

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

объект Startup

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

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

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

имя сборки

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

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

Чтобы получить доступ к этому свойству программным способом, см. AssemblyName.

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

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

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

Чтобы получить доступ к этому свойству программным способом, см. RootNamespace.

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

Значок

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

Чтобы получить доступ к этому свойству программным способом, см. ApplicationIcon.

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

Ресурсы

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

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

Манифест

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

целевой платформы

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

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

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

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

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

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

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

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

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

Оптимизация кода

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

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

Указывает тип сведений об отладке, созданных компилятором. Сведения о настройке производительности отладки приложения см. в разделе параметр компилятора DebugType. Эта настройка имеет следующие параметры:

• никакой

  Указывает, что данные отладки не будут сгенерированы.

• полный

  Включает присоединение отладчика к работающей программе.

• pdbonly

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

• переносимые

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

• внедренные

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

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

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

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

уровня предупреждения

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

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

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

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

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

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

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

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

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

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

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

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

эталонной сборки

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

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

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

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

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

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

Публикация

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

публикации обрезанные

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

публикации собственных AOT

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

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

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

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

Этот параметр использует средство Al.exe, предоставленное пакетом SDK для Windows Software Development Kit (SDK), для подписывания сборки. Дополнительные сведения о Al.exeсм. в разделе How to: Sign an Assembly with a Strong Name.

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

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

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

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

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

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

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

Версия языка

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

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

Указывает, является ли целочисленная арифметическая инструкция, которая не находится в области проверенного или без флажка ключевых слов, и это приводит к значению вне диапазона типа данных приведет к исключению во время выполнения. Дополнительные сведения см. в разделе /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 параметры в пользовательском интерфейсе профилей запуска соответствуют параметрам в файле launchSettings.json проекта. Подробные сведения о том, как этот файл используется в разработке ASP.NET, см. в разработке и launchSettings.json.

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

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

См. также

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