Команда dotnet new list (перечень доступных шаблонов)

Эта статья относится к: ✔️ пакету SDK для .NET 6 и более поздних версий

Имя

dotnet new list — список доступных шаблонов для запуска с помощью dotnet new.

Synopsis

dotnet new list [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--tag <TAG>] [--type <TYPE>] [--columns <COLUMNS>] [--columns-all]
    [-o|--output <output>] [--project <project>] [--ignore-constraints]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

Команда dotnet new list выводит список доступных шаблонов для использования dotnet new. <Если указан TEMPLATE_NAME>, список шаблонов, содержащих указанное имя. Этот параметр содержит список только стандартных и установленных шаблонов. Чтобы найти шаблоны в NuGet, которые можно установить локально, используйте search команду.

Начиная с пакета SDK для .NET 7.0.100, команда может не отображать все шаблоны, list установленные на компьютере. Он учитывает результаты ограничений шаблона, а шаблоны, которые нельзя использовать, не будут отображаться. Чтобы принудительно отобразить все шаблоны, используйте --ignore-constraints этот параметр.

Замечание

Начиная с пакета SDK для .NET 7, синтаксис dotnet new изменился:

  • Варианты --list, --search, --installи --uninstall стали list, search, installи uninstall субкомандам.
  • Вариант --update-apply стал update подкоманда.
  • Чтобы использовать --update-check, используйте подкоманда update с параметром --check-only.

Другие варианты, которые были доступны раньше, по-прежнему доступны для использования с соответствующими подкомандами. Отдельная справка для каждой подкоманда доступна с помощью параметра -h или --help: dotnet new <subcommand> --help перечисляет все поддерживаемые параметры для подкоманда.

Кроме того, для dotnet newтеперь доступно завершение вкладки. Он поддерживает завершение для установленных имен шаблонов и для параметров выбранного шаблона. Чтобы активировать завершение вкладки для пакета SDK для .NET, см. раздел Включение завершения вкладки.

Примеры старого синтаксиса:

  • Список всех шаблонов одностраничного приложения (SPA):

    • с пакета SDK для .NET 6.0.100
    dotnet new --list spa
    • до пакета SDK для .NET 6.0.100
    dotnet new spa --list

Arguments

  • TEMPLATE_NAME

    Если аргумент указан, отображаются только шаблоны, содержащие <TEMPLATE_NAME> имя шаблона или короткое имя.

Options

  • --author <AUTHOR>

    Фильтрует шаблоны на основе автора шаблона. Поддерживается частичное совпадение. Доступно с пакета SDK для .NET 5.0.300.

  • --columns <COLUMNS>

    Разделенный запятыми список столбцов, отображаемых в выходных данных. Поддерживаемые столбцы:

    • language — разделенный запятыми список языков, поддерживаемых шаблоном.
    • tags — список тегов шаблона.
    • author — Автор шаблона.
    • type — Тип шаблона: проект или элемент.

    Имя шаблона и короткое имя всегда отображаются. Список столбцов по умолчанию — имя шаблона, короткое имя, язык и теги. Этот список эквивалентен указанию --columns=language,tags. Доступно с пакета SDK для .NET 5.0.300.

  • --columns-all

    Отображает все столбцы в выходных данных. Доступно с пакета SDK для .NET 5.0.300.

  • -d|--diagnostics

    Включает выходные данные диагностики. Доступно с версии пакета SDK для .NET 7.0.100.

  • -?|-h|--help

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

  • --ignore-constraints

    Отключает проверку соответствия шаблона ограничениям для запуска. Доступно с версии пакета SDK для .NET 7.0.100.

  • -lang|--language {C#|F#|VB}

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

    Замечание

    Некоторые оболочки интерпретируют # как специальный символ. В этих случаях заключите значение языкового параметра в кавычки. Например: dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

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

  • --project <PROJECT_PATH>

    Проект, в который добавляется шаблон. Для команды списка может потребоваться указать проект, который добавляется для правильной оценки ограничений шаблона. Доступно с версии пакета SDK для .NET 7.0.100.

  • --tag <TAG>

    Фильтрует шаблоны на основе тегов шаблонов. Для выбора шаблон должен иметь по крайней мере один тег, который точно соответствует критериям. Доступно с пакета SDK для .NET 5.0.300.

  • --type <TYPE>

    Фильтрует шаблоны на основе типа шаблона. Стандартные значения: project, itemи solution.

  • -v|--verbosity <LEVEL>

    Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic]. Дополнительные сведения см. в разделе LoggerVerbosity.

Примеры

  • Вывод списка всех шаблонов

    dotnet new list

  • Список всех шаблонов одностраничного приложения (SPA):

    dotnet new list spa

  • Вывод списка всех шаблонов, соответствующих подстроки.

    dotnet new list we

  • Вывод списка всех шаблонов, соответствующих подстроки , поддерживающей язык F#.

    dotnet new list we --language "F#"

  • Вывод списка всех шаблонов элементов.

    dotnet new list --type item

  • Список всех шаблонов C#, показывающих автора и тип в выходных данных.

    dotnet new list --language "C#" --columns "author,type"

См. также

  • Last updated on