dotnet new search

  • [アーティクル]

この記事の対象: ✔️ .NET Core 5.0.300 SDK 以降のバージョン

名前

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]

説明

dotnet new search コマンドを指定すると、dotnet new によってサポートされているテンプレートが NuGet.org で検索されます。<TEMPLATE_NAME> を指定すると、その指定した名前を含むテンプレートが検索されます。

Note

.NET 7 SDK 以降では、dotnet new 構文が変更されました。

  • --list、--search、--install--uninstall オプションが list、search、install、uninstall サブコマンドになりました。
  • --update-apply オプションが update サブコマンドになりました。
  • --update-check を使用するには、--check-only オプションと共に update サブコマンドを使用します。

以前に使用できたその他のオプションは、それぞれのサブコマンドで引き続き使用できます。 -h または --help オプションを使用すると、サブコマンドごとに個別のヘルプを使用できます。dotnet new <subcommand> --help では、サブコマンドでサポートされているすべてのオプションが一覧表示されます。

さらに、dotnet new でタブ補完が使用可能になりました。 インストールされているテンプレート名と、選択したテンプレートで提供されるオプションで補完がサポートされます。 .NET SDK のタブ補完をアクティブにするには、タブ補完を有効にすることに関するページを参照してください。

以前の構文の例:

  • "we" 部分文字列と一致し、F# 言語がサポートされている、NuGet で使用可能なすべてのテンプレートを検索します。

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

引数

  • TEMPLATE_NAME

    この引数を指定した場合、テンプレート名または短い名前に <TEMPLATE_NAME> が含まれるテンプレートのみが表示されます。 引数は、、、--tag--language--package、または--typeオプションが指定されていない場合--authorに必須です。

    Note

    .NET SDK 6.0.100 以降では、--search オプションの後に <TEMPLATE_NAME> 引数を指定できます。 たとえば、dotnet new --search web は dotnet new web --search と同じ結果になります。 複数の引数の使用は許可されません。

オプション

  • --author <AUTHOR>

    テンプレートの作成者に基づいてテンプレートをフィルター処理します。 部分一致がサポートされています。

  • --columns <COLUMNS>

    出力に表示する列の一覧。 サポートされる列は次のとおりです。

    • author - テンプレートの作成者。
    • language - テンプレート言語。
    • tags - テンプレート タグの一覧。
    • type - テンプレートの種類。

    テンプレート名、短い名前、パッケージ名、信頼できるソースかどうかの表示、ダウンロードの合計数が常に表示されます。 既定の列の一覧は、テンプレート名、短い名前、言語、パッケージ、信頼できるソースかどうかの表示、ダウンロードの合計です。 複数の列を指定するには、このオプションを --columns 複数回使用します。

  • --columns-all

    出力にすべての列を表示します。

  • -d|--diagnostics

    診断出力を有効にします。 .NET SDK 7.0.100 以降で使用できます。

  • -h|--help

    serach コマンドのヘルプを出力します。 .NET SDK 7.0.100 以降で使用できます。

  • -lang|--language <language>

    テンプレートでサポートされている言語に基づいてテンプレートをフィルター処理します。 使用できる言語はテンプレートによって異なります。使用できる言語は C#、F#、VB、SQL、JSON、TypeScript などです。 一部のテンプレートでは無効です。

    注意

    一部のシェルは # を特殊文字として解釈します。 そのような場合は、言語パラメーター値を引用符で囲みます。 たとえば、dotnet new --search --language "F#" のようにします。

  • --package <PACKAGE>

    NuGet のパッケージ ID に基づいてテンプレートをフィルター処理します。 部分一致がサポートされています。

  • --tag <TAG>

    テンプレートのタグに基づいてテンプレートをフィルター処理します。 選択するには、条件と完全に一致するタグがテンプレートに少なくとも 1 つ存在する必要があります。

  • --type <TYPE>

    テンプレートの種類に基づいてテンプレートをフィルター処理します。 事前定義されている値は project、item、solution です。

  • -v|--verbosity <LEVEL>

    コマンドの詳細レベルを設定します。 使用できる値は、q[uiet]、m[inimal]、n[ormal]、diag[nostic] です。 .NET SDK 7.0.100 以降で使用できます。

注意

テンプレート パッケージが dotnet new --search の結果に表示されるようにするには、NuGet パッケージの種類を Template に設定します。

例

  • spa 部分文字列と一致する NuGet で使用可能なすべてのテンプレートを検索します。

    dotnet new search spa

  • we 部分文字列と一致し、F# 言語がサポートされている、NuGet で使用可能なすべてのテンプレートを検索します。

    dotnet new search we --language "F#"

  • 項目テンプレートを検索します。

    dotnet new search --type item

  • すべての C# テンプレートを検索し、その種類とタグを出力に表示します。

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

関連項目