Поделиться через

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

  • Статья

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

dotnet new list

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

Шаблоны Короткое имя Язык Теги Введенный
Консольное приложение console [C#], F#, VB Общее/консоль 1.0
Библиотека классов classlib [C#], F#, VB Общее/библиотека 1.0
Приложение WPF wpf [C#], VB Общее/WPF 3.0 (5.0 для VB)
Библиотека классов WPF wpflib [C#], VB Общее/WPF 3.0 (5.0 для VB)
Библиотека настраиваемых элементов управления WPF wpfcustomcontrollib [C#], VB Общее/WPF 3.0 (5.0 для VB)
Библиотека пользовательских элементов управления WPF wpfusercontrollib [C#], VB Общее/WPF 3.0 (5.0 для VB)
Приложение Windows Forms (WinForms) winforms [C#], VB Общее (WinForms) 3.0 (5.0 для VB)
Библиотека классов для Windows Forms (WinForms) winformslib [C#], VB Общее (WinForms) 3.0 (5.0 для VB)
Служба рабочих ролей worker [C#] Общее/Рабочая роль/Веб 3.0
Тестовый проект MSTest mstest [C#], F#, VB Тест/MSTest 1.0
Класс тестирования MSTest mstest-class [C#], F#, VB Тест/MSTest 1.0
Тестовый проект NUnit 3 nunit [C#], F#, VB Тест/NUnit 2.1.400
Элемент теста NUnit 3 nunit-test [C#], F#, VB Тест/NUnit 2,2
Тестовый проект xUnit xunit [C#], F#, VB Тест/xUnit 1.0
Компонент Razor razorcomponent [C#] Веб/ASP.NET 3.0
Страница Razor page [C#] Веб/ASP.NET 2.0
MVC ViewImports viewimports [C#] Веб/ASP.NET 2.0
MVC ViewStart viewstart [C#] Веб/ASP.NET 2.0
Blazor Веб-приложение blazor [C#] Веб/Blazor 8.0.100
BlazorWebAssembly Автономное приложение blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
Пустой ASP.NET Core web [C#], F# Веб/пусто 1.0
Веб-приложение ASP.NET Core (модель — представление — контроллер) mvc [C#], F# Веб/MVC 1.0
Веб-приложение ASP.NET Core webapp, razor [C#] Веб/MVC и Razor Pages 2.2, 2.0
Библиотека классов Razor razorclasslib [C#] Веб/Razor/Библиотека/Библиотека классов Razor 2.1
Веб-API ASP.NET Core webapi [C#], F# Веб-API/API/Service/WebAPI 1.0
ASP.NET Core API webapiaot [C#] Веб-API/ВЕБ-API/СЛУЖБА 8.0
контроллер API ASP.NET Core apicontroller [C#] Веб/ASP.NET 8.0
Служба gRPC ASP.NET Core grpc [C#] Веб/gRPC 3.0
Файл dotnet gitignore gitignore Config 3.0
Файл global.json globaljson Config 2.0
Конфигурация NuGet nugetconfig Config 1.0
Локальное средство файла манифеста dotnet tool-manifest Config 3.0
Файл веб-конфигурации webconfig Config 1.0
Файл решения sln Решение 1.0
Файл буфера протокола proto Веб/gRPC 3.0
Файл EditorConfig editorconfig Config 6,0

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

Шаблоны Короткое имя Язык Теги Прекращено с момента
Использование ASP.NET Core с Angular angular [C#] MVC/Веб/SPA 8.0
Использование ASP.NET Core с React.js react [C#] MVC/Веб/SPA 8.0
Серверное приложение Blazor blazorserver [C#] Веб/Blazor 8.0
Пустое приложение Blazor Server blazorserver-empty [C#] Веб/Blazor 8.0
Пустое приложение Blazor WebAssembly blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

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

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

console

  • -f|--framework <FRAMEWORK>

    Указывает целевую платформу. Доступно, начиная с пакета SDK для .NET Core 3.0.

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

    Версия пакета SDK Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    3.1 netcoreapp3.1

    Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 7, то единственным доступным --framework значением является net7.0. Если установить пакет SDK для .NET 6, значение net6.0 становится доступным для --framework. Если вы установите пакет SDK для .NET Core 3.1, становится доступным netcoreapp3.1 и т. д. Поэтому, указав --framework netcoreapp3.1, вы можете вести разработку под .NET Core 3.1 даже при использовании dotnet new в пакете SDK для .NET 6.

    Также для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета 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#. Доступно начиная с пакета SDK для .NET Core 2.2.

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

  • --no-restore

    Если указано — во время создания проекта не выполняется неявное восстановление. Доступно начиная с пакета SDK для .NET Core 2.2.

  • --use-program-main

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

classlib

  • -f|--framework <FRAMEWORK>

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

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

  • --langVersion <VERSION_NUMBER>

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

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

  • --no-restore

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

wpf, , wpflibwpfcustomcontrollibwpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Указывает целевую платформу. Для пакета SDK для .NET 8 используется net8.0значение по умолчанию. Доступно, начиная с пакета SDK для .NET Core 3.1.

  • --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 8 является net8.0. Доступно, начиная с пакета SDK для .NET Core 3.1.

    Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета 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 для .NET Core 3.0.

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

    Версия пакета SDK Default value
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 6, то для параметра --framework доступно только значение net6.0. При установке пакета SDK для .NET 5 для параметра --framework станет доступно значение net5.0. Если вы установите пакет SDK для .NET Core 3.1, становится доступным netcoreapp3.1 и т. д. Поэтому, указав --framework netcoreapp3.1, вы можете вести разработку под .NET Core 3.1 даже при использовании dotnet new в пакете SDK для .NET 6.

  • --no-restore

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

  • --sdk

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

  • --test-runner <TEST_RUNNER>

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

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

  • --coverage-tool <COVERAGE_TOOL>

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

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

  • --extensions-profile <EXTENSIONS_PROFILE>

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

    • 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 для .NET Core 3.0.

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

    Версия пакета SDK Default value
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 6, то для параметра --framework доступно только значение net6.0. При установке пакета SDK для .NET 5 для параметра --framework станет доступно значение net5.0. Если вы установите пакет SDK для .NET Core 3.1, становится доступным netcoreapp3.1 и т. д. Поэтому, указав --framework netcoreapp3.1, вы можете вести разработку под .NET Core 3.1 даже при использовании dotnet new в пакете SDK для .NET 6.

  • -p|--enable-pack

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

  • --no-restore

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

nunit

  • -f|--framework <FRAMEWORK>

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

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

    Версия пакета SDK Default value
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

Возможность создания проекта для более ранней версии TFM зависит от наличия соответствующей установленной версии пакета SDK. Например, если установлен только пакет SDK для .NET 6, то для параметра --framework доступно только значение net6.0. При установке пакета SDK для .NET 5 для параметра --framework станет доступно значение net5.0. Если вы установите пакет SDK для .NET Core 3.1, становится доступным netcoreapp3.1 и т. д. Поэтому, указав --framework netcoreapp3.1, вы можете вести разработку под .NET Core 3.1 даже при использовании dotnet new в пакете SDK для .NET 6.

  • -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.

blazorserver

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

  • -au|--auth <AUTHENTICATION_TYPE>

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

    • None — без проверки подлинности (по умолчанию).
    • Individual — индивидуальная проверка подлинности.
    • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.
    • SingleOrg — проверка подлинности организации для отдельного клиента. Кроме того, используются 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.

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 метод.

blazorwasm

  • -f|--framework <FRAMEWORK>

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

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

    Версия пакета SDK Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

    Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета 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.

web

  • --exclude-launch-settings

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

  • -f|--framework <FRAMEWORK>

    Указывает целевую платформу. Опция не доступна в .NET Core 2.2 SDK.

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

    Версия пакета SDK Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета 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 для .NET Core 3.0.

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

    Версия пакета SDK Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0

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

  • --no-restore

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

  • --use-browserlink

    Включает BrowserLink в проект. Опция не доступна в .NET Core 2.2 и 3.1 SDK.

  • -rrc|--razor-runtime-compilation

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

  • --kestrelHttpPort

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

  • --kestrelHttpsPort

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

  • --use-program-main

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

angular, react

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

  • -au|--auth <AUTHENTICATION_TYPE>

    Тип проверки подлинности. Доступно, начиная с пакета SDK для .NET Core 3.0.

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

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

  • --exclude-launch-settings

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

  • --no-restore

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

  • --no-https

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

  • -uld|--use-local-db

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

  • -f|--framework <FRAMEWORK>

    Указывает целевую платформу. Опция не доступна в .NET Core 2.2 SDK.

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

    Примечание.

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

    Версия пакета SDK Default value
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.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.

razorclasslib

  • --no-restore

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

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

    Поддерживает добавление традиционных страниц Razor и представлений в дополнение к компонентам этой библиотеки. Доступно, начиная с пакета SDK для .NET Core 3.0.

webapiaot

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

  • --exclude-launch-settings

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

  • -f|--framework <FRAMEWORK>

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

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

    Версия пакета SDK Default value
    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). AddSwaggerGen, UseSwaggerи UseSwaggerUI не вызываются.

  • --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>

    Указывает целевую платформу. Опция не доступна в .NET Core 2.2 SDK.

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

    Версия пакета SDK Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    Для создания проекта, рассчитанного на более раннюю платформу, чем используемая вами версия пакета 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.

editorconfig

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

  • --empty

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

См. также