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

dotnet new search

  • Статья

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

Имя.

dotnet new search — поиск шаблонов, поддерживаемых dotnet new, в NuGet. org.

Краткие сведения

dotnet new search <TEMPLATE_NAME>

dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language <language>]
    [--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
    [--columns <author|language|tags|type>] [--columns-all]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

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

Примечание.

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

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

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

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

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

  • Поиск всех шаблонов, доступных в NuGet.org сопоставления подстроки "мы" и поддержки языка F#

    dotnet new we --search --language "F#"

Аргументы

  • TEMPLATE_NAME

    Если указан аргумент, будут отображаться только шаблоны, содержащие <TEMPLATE_NAME> в имени или кратком имени шаблона. Аргумент является обязательным, если --author--language, , --package--tagили --type параметры не указаны.

    Примечание.

    Начиная с пакета SDK для .NET версии 6.0.100 аргумент <TEMPLATE_NAME> можно помещать после параметра --search. Например, dotnet new --search web дает такой же результат, что и dotnet new web --search. Использование более чем одного аргумента не допускается.

Параметры

  • --author <AUTHOR>

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

  • --columns <COLUMNS>

    Список столбцов, отображаемых в выходных данных. Поддерживаются следующие столбцы:

    • author — автор шаблона;
    • language — язык шаблона.
    • tags — список тегов шаблона;
    • type — Тип шаблона.

    Имя шаблона, короткое имя, имя пакета, указание того, является ли он доверенным источником и всегда отображается общее количество скачиваемого файла. Список столбцов по умолчанию — имя шаблона, короткое имя, язык, пакет, указание, является ли он доверенным источником и общими загрузками. Чтобы указать несколько столбцов, используйте --columns параметр несколько раз.

  • --columns-all

    Отображает все столбцы в выходных данных.

  • -d|--diagnostics

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

  • -h|--help

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

  • -lang|--language <language>

    Фильтрует шаблоны на основе языка, поддерживаемого шаблоном. Язык, принятый в зависимости от шаблона, возможные языки: C#, F#, VB, SQL, JSON, TypeScript и многое другое. Не является допустимым для некоторых шаблонов.

    Примечание.

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

  • --package <PACKAGE>

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

  • --tag <TAG>

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

  • --type <TYPE>

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

  • -v|--verbosity <LEVEL>

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

Примечание.

Чтобы пакет шаблона отображался в результате dotnet new --search, для типа пакета NuGet задайте значение Template.

Примеры

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

    dotnet new search spa

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

    dotnet new search we --language "F#"

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

    dotnet new search --type item

  • Поиск всех шаблонов C# с указанием типа и тегов в выходных данных.

    dotnet new search --language "C#" --columns "type" --columns "tags"

См. также