dotnet new list

  • [アーティクル]

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

名前

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 コマンドを使用します。

.NET SDK 7.0.100 以降、list コマンドでは、マシンにインストールされているすべてのテンプレートが表示されない場合があります。 テンプレート制約の結果が考慮され、使用できないテンプレートは表示されません。 すべてのテンプレートを強制的に表示するには、--ignore-constraints オプションを使用します。

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 のタブ補完をアクティブにするには、タブ補完を有効にすることに関するページを参照してください。

以前の構文の例:

  • すべてのシングルページ アプリケーション (SPA) テンプレートの一覧を表示します。

    • .NET SDK 6.0.100 以降
    dotnet new --list spa
    • .NET SDK 6.0.100 より前
    dotnet new spa --list

引数

  • TEMPLATE_NAME

    この引数を指定した場合、テンプレート名または短い名前に <TEMPLATE_NAME> が含まれるテンプレートのみが表示されます。

オプション

  • --author <AUTHOR>

    テンプレートの作成者に基づいてテンプレートをフィルター処理します。 部分一致がサポートされています。 .NET SDK 5.0.300 以降で使用できます。

  • --columns <COLUMNS>

    出力に表示する列のコンマ区切りのリスト。 サポートされる列は次のとおりです。

    • language - テンプレートでサポートされている言語のコンマ区切りの一覧。
    • tags - テンプレート タグの一覧。
    • author - テンプレートの作成者。
    • type - テンプレートの種類: project または item。

    テンプレート名と短い名前は常に表示されます。 列の既定の一覧は、テンプレート名、短い名前、言語、タグです。 この一覧は、--columns=language,tags を指定することと同じです。 .NET SDK 5.0.300 以降で使用できます。

  • --columns-all

    出力にすべての列を表示します。 .NET SDK 5.0.300 以降で使用できます。

  • -d|--diagnostics

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

  • -h|--help

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

  • --ignore-constraints

    テンプレートが実行する制約を満たしているかの確認を無効にします。 .NET SDK 7.0.100 以降で使用できます。

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

    テンプレートでサポートされている言語に基づいてテンプレートをフィルター処理します。 受け付けられる言語は、テンプレートによって異なります。 一部のテンプレートでは無効です。

    注意

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

  • -o|--output <OUTPUT_DIRECTORY>

    生成された出力を配置する場所。 既定値は、現在のディレクトリです。 list コマンドでは、テンプレートの制約を正しく評価するために出力ディレクトリを指定する必要がある場合があります。 .NET SDK 7.0.100 以降で使用できます。

  • --project <PROJECT_PATH>

    テンプレートが追加されるプロジェクト。 list コマンドでは、テンプレートの制約を正しく評価するためにテンプレートを追加するプロジェクトを指定する必要がある場合があります。 .NET SDK 7.0.100 以降で使用できます。

  • --tag <TAG>

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

  • --type <TYPE>

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

  • -v|--verbosity <LEVEL>

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

例

  • すべてのテンプレートの一覧を表示します

    dotnet new list

  • すべてのシングルページ アプリケーション (SPA) テンプレートの一覧を表示します。

    dotnet new list spa

  • 部分文字列 we に一致するすべてのテンプレートの一覧を取得します。

    dotnet new list we

  • F# 言語をサポートし、we 部分文字列に一致する、すべてのテンプレートの一覧を表示します。

    dotnet new list we --language "F#"

  • すべての項目テンプレートの一覧を表示します。

    dotnet new list --type item

  • すべての C# テンプレートの一覧を表示します。出力では作成者と種類を示します。

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

関連項目