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"