Шаблоны по умолчанию для dotnet new

При установке пакета SDK для .NET вы получаете более десяти встроенных шаблонов для создания проектов и файлов, включая консольные приложения, библиотеки классов, проекты модульных тестов, приложения ASP.NET Core (в том числе проекты Angular и React) и файлы конфигурации. Чтобы получить список встроенных шаблонов, выполните dotnet new list команду:

dotnet new list

Параметры шаблонов

Шаблоны, которые вставляются с пакетом SDK для .NET, имеют параметры, относящиеся к шаблону. Чтобы отобразить дополнительные параметры, доступные для шаблона, используйте --help параметр с аргументом имени шаблона, например: dotnet new console --help В разделах, относящихся к шаблону, в этой статье также описываются параметры.

Если шаблон поддерживает несколько языков программирования, параметр --help отобразит справку по шаблону на языке по умолчанию. Объединяя его с параметром--language, вы можете увидеть справку по другим языкам: dotnet new console --help --language F#

Предварительно установленные шаблоны

В следующей таблице показаны шаблоны, которые предварительно установлены с помощью пакета SDK для .NET. Язык по умолчанию для шаблона отображается в квадратных скобках. Чтобы просмотреть все параметры, относящиеся к шаблону, выберите ссылку с коротким именем.

buildprops

Создает файл Directory.Build.props для настройки свойств MSBuild для всего дерева папок. Дополнительные сведения см. в разделе "Настройка сборки".

• --inherit

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

• --use-artifacts

  При указании добавляет свойство для включения выходного макета артефактов. Это распространенный шаблон для проектов, которые создают артефакты сборки, такие как пакеты NuGet, которые помещаются в общую структуру папок. Дополнительные сведения см. в разделе " Макет выходных данных артефактов".

buildtargets

Создает файл Directory.Build.targets для настройки целевых объектов и задач MSBuild для всего дерева папок. Дополнительные сведения см. в разделе "Настройка сборки".

• --inherit

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

console

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице перечислены значения по умолчанию в соответствии с используемой версией пакета SDK:

  Версия пакета SDK	Значение по умолчанию
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

  Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 9, то единственным значением, доступным для --framework, является net9.0. Например, если установить пакет SDK для .NET 8, значение net8.0 становится доступным для --framework. Таким образом, указав --framework net8.0 вы можете использовать .NET 8 даже при выполнении dotnet new в пакете SDK для .NET 9.

  Также для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, можно установить пакет NuGet для шаблона. В таких типах проектов, как Common, webи SPA, используются разные пакеты для моникера целевой платформы (TFM). Например, чтобы создать проект console, предназначенный для netcoreapp1.0, выполните dotnet new install в Microsoft.DotNet.Common.ProjectTemplates.1.x.

• --langVersion <VERSION_NUMBER>

  Задает свойство LangVersion в созданном файле проекта. Например, вам требуется --langVersion 7.3, чтобы использовать C# 7.3. Не поддерживается для F#.

  Список версий C# по умолчанию см. в разделе Значения по умолчанию.

• --no-restore

  Если указано — во время создания проекта не выполняется неявное восстановление.

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false. Доступно только для C#.

classlib

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу. Значения: net9.0, net8.0или net7.0 создать библиотеку классов .NET или netstandard2.1netstandard2.0 создать библиотеку классов .NET Standard. Значение по умолчанию для пакета SDK для .NET 9.0.x — net9.0.

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --langVersion <VERSION_NUMBER>

  Задает свойство LangVersion в созданном файле проекта. Например, вам требуется --langVersion 7.3, чтобы использовать C# 7.3. Не поддерживается для F#.

  Список версий C# по умолчанию см. в разделе Значения по умолчанию.

• --no-restore

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

wpf, , wpflibwpfcustomcontrollibwpfusercontrollib

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу. Для пакета SDK для .NET 9 значение по умолчанию net9.0.

• --langVersion <VERSION_NUMBER>

  Задает свойство LangVersion в созданном файле проекта. Например, вам требуется --langVersion 7.3, чтобы использовать C# 7.3.

  Список версий C# по умолчанию см. в разделе Значения по умолчанию.

• --no-restore

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

winforms, winformslib

• --langVersion <VERSION_NUMBER>

  Задает свойство LangVersion в созданном файле проекта. Например, вам требуется --langVersion 7.3, чтобы использовать C# 7.3.

  Список версий C# по умолчанию см. в разделе Значения по умолчанию.

• --no-restore

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

worker, grpc

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу. Значение по умолчанию для пакета SDK для .NET 9 — net9.0.

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• --no-restore

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

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

mstest

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 9, то единственным значением, доступным для --framework, является net9.0. Например, при установке пакета SDK для .NET 8 значение net8.0 становится доступным для --framework. Таким образом, указав --framework net8.0 вы можете использовать .NET 8 даже при выполнении dotnet new в пакете SDK для .NET 9.

• --no-restore

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

• --sdk

  Используйте стиль проекта MSTest.Sdk.

• --test-runner <TEST_RUNNER>

  Средство выполнения или платформа для тестового проекта. Возможны следующие значения:

  • VSTest — платформа VSTest (по умолчанию).
  • MSTest — Microsoft.Testing.Platform.

• --coverage-tool <COVERAGE_TOOL>

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

  • Microsoft.CodeCoverage — Покрытие кода Майкрософт (по умолчанию).
  • coverlet — средство покрытия обложки.

• --extensions-profile <EXTENSIONS_PROFILE>

  Профиль расширений ПАКЕТА SDK при использовании Microsoft.Testing.Platform. Возможны следующие значения:

  • Default — Профиль расширений по умолчанию (по умолчанию).
  • None — расширения не включены.
  • AllMicrosoft — включите все расширения, отправленные корпорацией Майкрософт (включая расширения с ограничивающей лицензией).

• --fixture <FIXTURE>

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

  • None - Нет методов светильника.
  • AssemblyInitialize — Метод светильника AssemblyInitialize.
  • AssemblyCleanup — Метод исправления AssemblyCleanup.
  • ClassInitialize — Метод светильника ClassInitialize.
  • ClassCleanup — Метод исправления ClassCleanup.
  • TestInitialize — метод проверки инициализации.
  • TestCleanup — Метод исправления TestCleanup.

  Где разрешено несколько значений.

• -p|--enable-pack

  Включает упаковку проекта с помощью команды dotnet pack.

mstest-class

• --fixture <FIXTURE>

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

  • None - Нет методов светильника.
  • AssemblyInitialize — Метод светильника AssemblyInitialize.
  • AssemblyCleanup — Метод исправления AssemblyCleanup.
  • ClassInitialize — Метод светильника ClassInitialize.
  • ClassCleanup — Метод исправления ClassCleanup.
  • TestInitialize — метод проверки инициализации.
  • TestCleanup — Метод исправления TestCleanup.

  Где разрешено несколько значений.

xunit

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 9, то единственным значением, доступным для --framework, является net9.0. Например, при установке пакета SDK для .NET 8 значение net8.0 становится доступным для --framework. Таким образом, указав --framework net8.0 вы можете использовать .NET 8 даже при выполнении dotnet new в пакете SDK для .NET 9.

• -p|--enable-pack

  Включает упаковку проекта с помощью команды dotnet pack.

• --no-restore

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

nunit

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 9, то единственным значением, доступным для --framework, является net9.0. Например, при установке пакета SDK для .NET 8 значение net8.0 становится доступным для --framework. Таким образом, указав --framework net8.0 вы можете использовать .NET 8 даже при выполнении dotnet new в пакете SDK для .NET 9.

• -p|--enable-pack

  Включает упаковку проекта с помощью команды dotnet pack.

• --no-restore

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

page

• -na|--namespace <NAMESPACE_NAME>

  Пространство имен для сформированного кода. Значение по умолчанию — MyApp.Namespace.

• -np|--no-pagemodel

  Создает страницу без PageModel.

viewimports, proto

• -na|--namespace <NAMESPACE_NAME>

  Пространство имен для сформированного кода. Значение по умолчанию — MyApp.Namespace.

blazor

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  Этот шаблон доступен для .NET 8 или более поздней версии.

• --no-restore

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

• --exclude-launch-settings

  Исключает launchSettings.json из созданного приложения.

• -int|--interactivity <None|Server|Webassembly|Auto >

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

  • None — нет интерактивности (только для отрисовки на стороне статического сервера).
  • Server — (по умолчанию) Запускает приложение на сервере с интерактивной отрисовкой на стороне сервера.
  • WebAssembly — запускает приложение с помощью клиентской отрисовки в браузере WebAssembly.
  • Auto— использует интерактивную отрисовку на стороне сервера при скачивании Blazor пакета и активации Blazor среды выполнения на клиенте, а затем использует отрисовку на стороне клиента.WebAssembly

• --empty

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

• -au|--auth <AUTHENTICATION_TYPE>

  Тип проверки подлинности. Возможны следующие значения:

  • None — без проверки подлинности (по умолчанию).
  • Individual — индивидуальная проверка подлинности.

• -uld|--use-local-db

  Указывает, что вместо SQLite следует использовать LocalDB. Применяется только при проверке подлинности Individual.

• -ai|--all-interactive

  Делает каждую страницу интерактивной, применяя интерактивный режим отрисовки на верхнем уровне. Если falseстраницы используют статическую отрисовку на стороне сервера по умолчанию и могут быть помечены интерактивными на каждой странице или на основе компонентов. Этот параметр действует только в том случае, если -i|--interactivity параметр не задан None.

• --no-https

  Отключает протокол HTTPS. Этот параметр применяется только в том случае, если Individual этот параметр не выбран -au|--auth .

• --use-program-main

  Если задано, то вместо инструкций верхнего уровня создается явный Program класс и Main метод.

web

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --no-restore

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

• --no-https

  Отключает протокол HTTPS.

• --kestrelHttpPort

  Номер порта для конечной точки HTTP в launchSettings.json.

• --kestrelHttpsPort

  Номер порта для конечной точки HTTPS в launchSettings.json. Неприменимо, если используется параметр no-https (no-https игнорируется, если для --auth выбран параметр проверки подлинности отдельного пользователя или организации).

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

mvc, webapp

• -au|--auth <AUTHENTICATION_TYPE>

  Тип проверки подлинности. Возможны следующие значения:

  • None — без проверки подлинности (по умолчанию).
  • Individual — индивидуальная проверка подлинности.
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента. Клиенты External ID Entra также используют SingleOrg.
  • MultiOrg — проверка подлинности организации для нескольких клиентов.
  • Windows — проверка подлинности Windows.

• --aad-b2c-instance <INSTANCE>

  Экземпляр Azure Active Directory B2C, к которому выполняется подключение. Используется с проверкой подлинности IndividualB2C. Значение по умолчанию — https://login.microsoftonline.com/tfp/.

• -ssp|--susi-policy-id <ID>

  Идентификатор политики входа и регистрации для этого проекта. Используется с проверкой подлинности IndividualB2C.

• -rp|--reset-password-policy-id <ID>

  Идентификатор политики сброса паролей для этого проекта. Используется с проверкой подлинности IndividualB2C.

• -ep|--edit-profile-policy-id <ID>

  Идентификатор политики изменения профилей для этого проекта. Используется с проверкой подлинности IndividualB2C.

• --aad-instance <INSTANCE>

  Экземпляр Azure Active Directory, к которому выполняется подключение. Используется с проверкой подлинности SingleOrg или MultiOrg. Значение по умолчанию — https://login.microsoftonline.com/.

• --client-id <ID>

  Идентификатор клиента для этого проекта. Используется с проверкой подлинности IndividualB2C, SingleOrg или MultiOrg. Значение по умолчанию — 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

  Домен клиента каталога. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — qualified.domain.name.

• --tenant-id <ID>

  Идентификатор TenantId каталога, к которому устанавливается подключение. Используется с проверкой подлинности SingleOrg. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

  Путь запроса по базовому пути кода URI перенаправления для приложения. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — /signin-oidc.

• -r|--org-read-access

  Предоставляет приложению доступ к каталогу для чтения. Применяется только при проверке подлинности SingleOrg или MultiOrg.

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• --no-https

  Отключает протокол HTTPS. Этот параметр применяется, только если Individual, IndividualB2C, SingleOrg или MultiOrg не используются.

• -uld|--use-local-db

  Указывает, что вместо SQLite следует использовать LocalDB. Применяется только при проверке подлинности Individual или IndividualB2C.

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --no-restore

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

• --use-browserlink

  Включает BrowserLink в проект.

• -rrc|--razor-runtime-compilation

  Определяет, настроен ли проект для использования компиляции среды выполнения Razor в отладочных сборках.

• --kestrelHttpPort

  Номер порта для конечной точки HTTP в launchSettings.json.

• --kestrelHttpsPort

  Номер порта для конечной точки HTTPS в launchSettings.json. Неприменимо, если используется параметр no-https (no-https игнорируется, если для --auth выбран параметр проверки подлинности отдельного пользователя или организации).

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

razorclasslib

• --no-restore

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

• -s|--support-pages-and-views

  Поддерживает добавление традиционных страниц Razor и представлений в дополнение к компонентам этой библиотеки.

webapiaot

Создает проект веб-API с включенной публикацией AOT. Дополнительные сведения см. в разделе о развертывании AOT native AOT и шаблоне веб-API (Native AOT).

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

• --no-restore

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

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

webapi

• -au|--auth <AUTHENTICATION_TYPE>

  Тип проверки подлинности. Возможны следующие значения:

  • None — без проверки подлинности (по умолчанию).
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента. Клиенты External ID Entra также используют SingleOrg.
  • Windows — проверка подлинности Windows.

• --aad-b2c-instance <INSTANCE>

  Экземпляр Azure Active Directory B2C, к которому выполняется подключение. Используется с проверкой подлинности IndividualB2C. Значение по умолчанию — https://login.microsoftonline.com/tfp/.

• -minimal|--use-minimal-apis

  Создание проекта, использующего минимальные API из ASP.NET Core. falseЗначение по умолчанию равно, но этот параметр переопределяется-controllers. Так как значение -controllers по умолчанию используется false, ввод dotnet new webapi без указания любого параметра создает минимальный проект API.

• -ssp|--susi-policy-id <ID>

  Идентификатор политики входа и регистрации для этого проекта. Используется с проверкой подлинности IndividualB2C.

• --aad-instance <INSTANCE>

  Экземпляр Azure Active Directory, к которому выполняется подключение. Используется с проверкой подлинности SingleOrg. Значение по умолчанию — https://login.microsoftonline.com/.

• --client-id <ID>

  Идентификатор клиента для этого проекта. Используется с проверкой подлинности IndividualB2C или SingleOrg. Значение по умолчанию — 11111111-1111-1111-11111111111111111.

• -controllers|--use-controllers

  Следует ли использовать контроллеры вместо минимальных API. Если этот параметр и -minimal заданы, этот параметр переопределяет значение, указанное в параметре -minimal. По умолчанию — false. Доступно с пакета SDK для .NET 8.

• --domain <DOMAIN>

  Домен клиента каталога. Используется с проверкой подлинности IndividualB2C или SingleOrg. Значение по умолчанию — qualified.domain.name.

• --tenant-id <ID>

  Идентификатор TenantId каталога, к которому устанавливается подключение. Используется с проверкой подлинности SingleOrg. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Предоставляет приложению доступ к каталогу для чтения. Применяется только при проверке подлинности SingleOrg.

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• --no-openapi

  Отключает поддержку OpenAPI (Swagger). AddOpenApi и MapOpenApi не вызываются.

• --no-https

  Отключает протокол HTTPS. Профиль запуска https не создается в launchSettings.json. app.UseHstsи app.UseHttpsRedirection не вызываются в Program.cs Startup.cs/. Этот параметр применяется, только если IndividualB2C или SingleOrg не используются для проверки подлинности.

• -uld|--use-local-db

  Указывает, что вместо SQLite следует использовать LocalDB. Применяется только при проверке подлинности IndividualB2C.

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --no-restore

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

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

apicontroller

Контроллер API с действиями чтения и записи или без нее.

• -p:n|--name <NAME>

  Пространство имен для созданного кода. По умолчанию — MyApp.Namespace.

• -ac|--actions

  Создайте контроллер с действиями чтения и записи. По умолчанию — false.

globaljson

• --sdk-version <VERSION_NUMBER>

  Задает версию пакета SDK для .NET, используемую в файле global.json.

• --roll-forward <ROLL_FORWARD_POLICY>

  Политика отката, используемая при выборе версии пакета SDK, либо в качестве резервного копирования при отсутствии определенной версии пакета SDK, либо в качестве директивы для использования более поздней версии. Дополнительные сведения см. в статье global-json.

• --test-runner <TEST_RUNNER>

  Этот параметр был представлен в пакете SDK для .NET 10 и указывает средство выполнения теста, используемое в VSTest или Microsoft.Testing.Platform. Значение по умолчанию — VSTest.

sln

Создает пустой файл решения, содержащий проекты.

editorconfig

Создает файл .editorconfig для настройки параметров стиля кода.

• --empty

  Создает пустой .editorconfig вместо стандартного шаблона для .NET.

Неподдерживаемые шаблоны

В следующей таблице показаны шаблоны, которые были прекращены и больше не установлены с помощью пакета SDK для .NET. Чтобы просмотреть все параметры, относящиеся к шаблону, выберите ссылку с коротким именем.

angular, react

Прекращено с пакета SDK для .NET 8.

• -au|--auth <AUTHENTICATION_TYPE>

  Тип проверки подлинности.

  Возможны следующие значения:

  • None — без проверки подлинности (по умолчанию).
  • Individual — индивидуальная проверка подлинности.

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• --no-restore

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

• --no-https

  Отключает протокол HTTPS. Данная опция применяется только в том случае, если проверкой подлинности является None.

• -uld|--use-local-db

  Указывает, что вместо SQLite следует использовать LocalDB. Применяется только при проверке подлинности Individual или IndividualB2C.

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Примечание.

  Однако не существует шаблона net8.0React, если вы заинтересованы в разработке приложений React с помощью ASP.NET Core, ознакомьтесь с общими сведениями о одностраничных приложениях (SPAs) в ASP.NET Core.

  Версия пакета SDK	Значение по умолчанию
  7.0	net7.0

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --kestrelHttpPort

  Номер порта для конечной точки HTTP в launchSettings.json.

• --kestrelHttpsPort

  Номер порта для конечной точки HTTPS в launchSettings.json. Неприменимо, если используется параметр no-https (no-https игнорируется, если для --auth выбран параметр проверки подлинности отдельного пользователя или организации).

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

blazorserver

Прекращено с пакета SDK для .NET 8.

• -au|--auth <AUTHENTICATION_TYPE>

  Тип проверки подлинности. Возможны следующие значения:

  • None — без проверки подлинности (по умолчанию).
  • Individual — индивидуальная проверка подлинности.
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента. Entra.
  • MultiOrg — проверка подлинности организации для нескольких клиентов.
  • Windows — проверка подлинности Windows.

• --aad-b2c-instance <INSTANCE>

  Экземпляр Azure Active Directory B2C, к которому выполняется подключение. Используется с проверкой подлинности IndividualB2C. Значение по умолчанию — https://login.microsoftonline.com/tfp/.

• -ssp|--susi-policy-id <ID>

  Идентификатор политики входа и регистрации для этого проекта. Используется с проверкой подлинности IndividualB2C.

• -rp|--reset-password-policy-id <ID>

  Идентификатор политики сброса паролей для этого проекта. Используется с проверкой подлинности IndividualB2C.

• -ep|--edit-profile-policy-id <ID>

  Идентификатор политики изменения профилей для этого проекта. Используется с проверкой подлинности IndividualB2C.

• --aad-instance <INSTANCE>

  Экземпляр Azure Active Directory, к которому выполняется подключение. Используется с проверкой подлинности SingleOrg или MultiOrg. Значение по умолчанию — https://login.microsoftonline.com/.

• --client-id <ID>

  Идентификатор клиента для этого проекта. Используется с проверкой подлинности IndividualB2C, SingleOrg или MultiOrg. Значение по умолчанию — 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

  Домен клиента каталога. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — qualified.domain.name.

• --tenant-id <ID>

  Идентификатор TenantId каталога, к которому устанавливается подключение. Используется с проверкой подлинности SingleOrg. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

  Путь запроса по базовому пути кода URI перенаправления для приложения. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — /signin-oidc.

• -r|--org-read-access

  Предоставляет приложению доступ к каталогу для чтения. Применяется только при проверке подлинности SingleOrg или MultiOrg.

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• --no-https

  Отключает протокол HTTPS. Этот параметр применяется, только если Individual, IndividualB2C, SingleOrg или MultiOrg не используются для --auth.

• -uld|--use-local-db

  Указывает, что вместо SQLite следует использовать LocalDB. Применяется только при проверке подлинности Individual или IndividualB2C.

• --no-restore

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

• --kestrelHttpPort

  Номер порта для конечной точки HTTP в launchSettings.json.

• --kestrelHttpsPort

  Номер порта для конечной точки HTTPS в launchSettings.json. Неприменимо, если используется параметр no-https (no-https игнорируется, если для --auth выбран параметр проверки подлинности отдельного пользователя или организации).

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

blazorwasm

• -f|--framework <FRAMEWORK>

  Указывает целевую платформу.

  В следующей таблице приведены значения по умолчанию в соответствии с версией пакета SDK, которую вы используете:

  Версия пакета SDK	Значение по умолчанию
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета SDK, см. информацию о параметре --framework для проектов console выше в этой статье.

• --no-restore

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

• -ho|--hosted

  Включает узел ASP.NET Core для приложения BlazorWebAssembly.

• -au|--auth <AUTHENTICATION_TYPE>

  Тип проверки подлинности. Возможны следующие значения:

  • None — без проверки подлинности (по умолчанию).
  • Individual — индивидуальная проверка подлинности.
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента. Клиенты External ID Entra также используют SingleOrg.

• --authority <AUTHORITY>

  Центр поставщика OIDC. Используется с проверкой подлинности Individual. Значение по умолчанию — https://login.microsoftonline.com/.

• --aad-b2c-instance <INSTANCE>

  Экземпляр Azure Active Directory B2C, к которому выполняется подключение. Используется с проверкой подлинности IndividualB2C. Значение по умолчанию — https://aadB2CInstance.b2clogin.com/.

• -ssp|--susi-policy-id <ID>

  Идентификатор политики входа и регистрации для этого проекта. Используется с проверкой подлинности IndividualB2C.

• --aad-instance <INSTANCE>

  Экземпляр Azure Active Directory, к которому выполняется подключение. Используется с проверкой подлинности SingleOrg. Значение по умолчанию — https://login.microsoftonline.com/.

• --client-id <ID>

  Идентификатор клиента для этого проекта. Используйте для проверки подлинности IndividualB2C, SingleOrg или Individual в автономных сценариях. Значение по умолчанию — 33333333-3333-3333-33333333333333333.

• --domain <DOMAIN>

  Домен клиента каталога. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — qualified.domain.name.

• --app-id-uri <URI>

  URI идентификатора приложения для серверного API-интерфейса, который требуется вызвать. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — api.id.uri.

• --api-client-id <ID>

  Идентификатор клиента для API, размещенного на сервере. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — 11111111-1111-1111-11111111111111111.

• -s|--default-scope <SCOPE>

  Область API, которую клиент должен запросить для подготовки маркера доступа. Используется с проверкой подлинности SingleOrg или IndividualB2C. Значение по умолчанию — user_impersonation.

• --tenant-id <ID>

  Идентификатор TenantId каталога, к которому устанавливается подключение. Используется с проверкой подлинности SingleOrg. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Предоставляет приложению доступ к каталогу для чтения. Применяется только при проверке подлинности SingleOrg.

• --exclude-launch-settings

  Исключает файл launchSettings.json из создаваемого шаблона.

• -p|--pwa

  Создает прогрессивное веб-приложение (PWA), поддерживающее установку и автономное использование.

• --no-https

  Отключает протокол HTTPS. Этот параметр применяется, только если Individual, IndividualB2C или SingleOrg не используются для --auth.

• -uld|--use-local-db

  Указывает, что вместо SQLite следует использовать LocalDB. Применяется только при проверке подлинности Individual или IndividualB2C.

• --called-api-url <URL>

  URL-адрес API для вызова из веб-приложения. Применяется только при проверке подлинности SingleOrg или IndividualB2C без указания узла ASP.NET Core. Значение по умолчанию — https://graph.microsoft.com/v1.0/me.

• --calls-graph

  Указывает, вызывает ли веб-приложение Microsoft Graph. Применяется только при проверке подлинности SingleOrg.

• --called-api-scopes <SCOPES>

  Области для запроса вызова API из веб-приложения. Применяется только при проверке подлинности SingleOrg или IndividualB2C без указания узла ASP.NET Core. Значение по умолчанию — user.read.

• --kestrelHttpPort

  Номер порта для конечной точки HTTP в launchSettings.json.

• --kestrelHttpsPort

  Номер порта для конечной точки HTTPS в launchSettings.json. Неприменимо, если используется параметр no-https (no-https игнорируется, если для --auth выбран параметр проверки подлинности отдельного пользователя или организации).

• --use-program-main

  Если значение указано, вместо инструкций верхнего уровня будет использоваться явный класс Program и метод Main. Доступно, начиная с пакета SDK для .NET 6.0.300. Значение по умолчанию: false.

См. также

• команда dotnet new
• команда dotnet new list
• Пользовательские шаблоны для команды dotnet new
• Создание пользовательского шаблона для dotnet
• Неявные директивы using