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

dotnet new list

  • Статья

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

Имя

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

Краткий обзор

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]

Описание

Команда 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 см. в разделе Включение завершения вкладки.

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

  • Список всех шаблонов одностраничных приложений:

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

Аргументы

  • TEMPLATE_NAME

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

Параметры

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

    Выводит справку по команде list. Доступно с версии пакета SDK для .NET 7.0.100.

  • --ignore-constraints

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

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

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

    Примечание

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

  • -o|--output <OUTPUT_DIRECTORY>

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

  • --project <PROJECT_PATH>

    Проект, в который добавляется шаблон. Для команды list может потребоваться указать проект, в который добавляется шаблон, чтобы правильно оценить ограничения для шаблона. Доступно с версии пакета 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] и diag[nostic]. Доступно с версии пакета SDK для .NET 7.0.100.

Примеры

  • Список всех шаблонов

    dotnet new list

  • Список всех шаблонов одностраничных приложений:

    dotnet new list spa

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

    dotnet new list we

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

    dotnet new list we --language "F#"

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

    dotnet new list --type item

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

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

См. также