Udostępnij przez

dotnet new list (polecenie)

Ten artykuł dotyczy: ✔️ zestaw .NET 6 SDK i nowsze wersje

Name

dotnet new list — Wyświetla listę dostępnych szablonów, które mają być uruchamiane 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]

Description

Polecenie dotnet new list wyświetla listę dostępnych szablonów do użycia z programem dotnet new. <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ędnia on wynik ograniczeń szablonu, a szablony, których nie można używać, nie będą wyświetlane. Aby wymusić wyświetlanie wszystkich szablonów, użyj --ignore-constraints opcji .

Uwaga / Notatka

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

  • Opcje --list, --search, --installi --uninstall stały się list, search, installi podpolecenia uninstall.
  • Opcja --update-apply stała się podpolecenia update.
  • Aby użyć --update-check, użyj podpolecenia update 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 opcji -h lub --help: dotnet new <subcommand> --help wyświetla listę wszystkich obsługiwanych opcji dla podpolecenia.

Ponadto ukończenie karty jest teraz dostępne dla dotnet new. Obsługuje uzupełnianie dla 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):

    • ponieważ zestaw .NET SDK 6.0.100
    dotnet new --list spa
    • przed zestawem .NET SDK 6.0.100
    dotnet new spa --list

Arguments

  • 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 wersji .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 wersji .NET SDK 5.0.300.

  • --columns-all

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

  • -d|--diagnostics

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

  • -?|-h|--help

    Wyświetla opis sposobu używania polecenia .

  • --ignore-constraints

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

  • -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łowe dla niektórych szablonów.

    Uwaga / Notatka

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

  • -o|--output <OUTPUT_DIRECTORY>

    Lokalizacja do umieszczenia wygenerowanych danych wyjściowych. Wartość domyślna to 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 7.0.100 zestawu .NET SDK.

  • --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 7.0.100 zestawu .NET SDK.

  • --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 wersji .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], d[etailed]i diag[nostic]. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.

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 autora i typ w danych wyjściowych.

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

Zobacz także

  • Last updated on