dotnet new list

  • Artykuł

Ten artykuł dotyczy: ✔️ .NET Core 3.1 SDK i nowsze wersje

Nazwa

dotnet new list — Wyświetla listę dostępnych szablonów do uruchomienia przy użyciu polecenia dotnet new.

Streszczenie

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]

Opis

Polecenie dotnet new list wyświetla listę dostępnych szablonów do użycia z dotnet newprogramem . <Jeśli określono TEMPLATE_NAME>, wyświetla listę szablonów zawierających określoną nazwę. Ta opcja wyświetla tylko domyślne i zainstalowane szablony. Aby znaleźć szablony w programie NuGet, które można zainstalować lokalnie, użyj search polecenia .

Począwszy od zestawu .NET SDK 7.0.100, list polecenie może nie wyświetlać wszystkich szablonów zainstalowanych na maszynie. Uwzględniany jest wynik ograniczeń szablonu, a szablony, których nie można używać, nie będą wyświetlane. Aby wymusić wyświetlenie wszystkich szablonów, użyj --ignore-constraints opcji .

Uwaga

Począwszy od zestawu .NET 7 SDK, składnia została zmieniona dotnet new :

  • Opcje --list, --search, --installi --uninstall stały się listpoleceniami , installsearch, i uninstall .
  • Opcja --update-apply stała się update podpolecenia.
  • Aby użyć --update-checkpolecenia , użyj update podpolecenia z opcją --check-only .

Inne opcje, które były dostępne wcześniej, są nadal dostępne do użycia z odpowiednimi podpoleceniami. Oddzielna pomoc dla każdego podpolecenia jest dostępna za pośrednictwem -h opcji lub --help : dotnet new <subcommand> --help wyświetla listę wszystkich obsługiwanych opcji dla podpolecenia.

Ponadto uzupełnianie karty jest teraz dostępne dla programu dotnet new. Obsługuje uzupełnianie zainstalowanych nazw szablonów i opcji dostępnych przez wybrany szablon. Aby aktywować uzupełnianie kart dla zestawu .NET SDK, zobacz Włączanie uzupełniania kart.

Przykłady starej składni:

  • Wyświetl listę wszystkich szablonów aplikacji jednostronicowej (SPA):

    • od zestawu .NET SDK 6.0.100
    dotnet new --list spa
    • przed zestawem .NET SDK 6.0.100
    dotnet new spa --list

Argumenty

  • TEMPLATE_NAME

    Jeśli argument zostanie określony, zostaną wyświetlone tylko szablony zawierające <TEMPLATE_NAME> nazwę szablonu lub krótką nazwę.

Opcje

  • --author <AUTHOR>

    Filtruje szablony na podstawie autora szablonu. Częściowe dopasowanie jest obsługiwane. Dostępne od zestawu .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Rozdzielona przecinkami lista kolumn do wyświetlenia w danych wyjściowych. Obsługiwane kolumny to:

    • language - Rozdzielona przecinkami lista języków obsługiwanych przez szablon.
    • tags - Lista tagów szablonu.
    • author - Autor szablonu.
    • type - Typ szablonu: projekt lub element.

    Nazwa szablonu i krótka nazwa są zawsze wyświetlane. Domyślną listą kolumn jest nazwa szablonu, krótka nazwa, język i tagi. Ta lista jest równoważna określeniu elementu --columns=language,tags. Dostępne od zestawu .NET SDK 5.0.300.

  • --columns-all

    Wyświetla wszystkie kolumny w danych wyjściowych. Dostępne od zestawu .NET SDK 5.0.300.

  • -d|--diagnostics

    Włącza dane wyjściowe diagnostyczne. Dostępne od wersji .NET SDK 7.0.100.

  • -h|--help

    Wyświetla pomoc dotyczącą polecenia listy. Dostępne od wersji .NET SDK 7.0.100.

  • --ignore-constraints

    Wyłącza sprawdzanie, czy szablon spełnia ograniczenia do uruchomienia. Dostępne od wersji .NET SDK 7.0.100.

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

    Filtruje szablony na podstawie języka obsługiwanego przez szablon. Akceptowany język różni się w zależności od szablonu. Nieprawidłowy dla niektórych szablonów.

    Uwaga

    Niektóre powłoki interpretują # jako znak specjalny. W takich przypadkach należy ująć wartość parametru języka w cudzysłów. Na przykład dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Lokalizacja do umieszczenia wygenerowanych danych wyjściowych. Ustawieniem domyślnym jest bieżący katalog. W przypadku polecenia listy może być konieczne określenie katalogu wyjściowego w celu poprawnej oceny ograniczeń szablonu. Dostępne od wersji .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Projekt, do którego został dodany szablon. W przypadku polecenia listy może być konieczne określenie projektu dodawanego do szablonu w celu poprawnej oceny ograniczeń szablonu. Dostępne od wersji .NET SDK 7.0.100.

  • --tag <TAG>

    Filtruje szablony na podstawie tagów szablonów. Aby go wybrać, szablon musi mieć co najmniej jeden tag, który dokładnie odpowiada kryteriom. Dostępne od zestawu .NET SDK 5.0.300.

  • --type <TYPE>

    Filtruje szablony na podstawie typu szablonu. Wstępnie zdefiniowane wartości to project, itemi solution.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], m[inimal], n[ormal]i diag[nostic]. Dostępne od wersji .NET SDK 7.0.100.

Przykłady

  • Wyświetlanie listy wszystkich szablonów

    dotnet new list

  • Wyświetl listę wszystkich szablonów aplikacji jednostronicowej (SPA):

    dotnet new list spa

  • Wyświetl listę wszystkich szablonów pasujących do podciągów.

    dotnet new list we

  • Wyświetl listę wszystkich szablonów pasujących do podciągów, które obsługują język F#.

    dotnet new list we --language "F#"

  • Wyświetl listę wszystkich szablonów elementów.

    dotnet new list --type item

  • Wyświetl listę wszystkich szablonów języka C#, pokazując autor i typ w danych wyjściowych.

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

Zobacz też