Dela via

dotnet ny lista

  • Artikel

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Name

dotnet new list– Visar tillgängliga mallar som ska köras med .dotnet new

Synopsis

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

Kommandot dotnet new list visar tillgängliga mallar som ska användas med dotnet new. Om TEMPLATE_NAME <> anges visas mallar som innehåller det angivna namnet. Det här alternativet visar endast standardmallar och installerade mallar. Använd kommandot för att hitta mallar i NuGet som du kan installera lokalt search .

Från och med .NET SDK 7.0.100 list kanske kommandot inte visar alla mallar som är installerade på datorn. Det tar hänsyn till resultatet av mallbegränsningar och de mallar som inte kan användas visas inte. Använd alternativet om du vill framtvinga visning av alla mallar --ignore-constraints .

Anteckning

Från och med .NET 7 SDK har syntaxen dotnet new ändrats:

  • Alternativen --list, --search, --installoch --uninstall blev list, search, installoch uninstall underkommandon.
  • Alternativet --update-apply blev update underkommandot.
  • Om du vill använda --update-checkanvänder du update underkommandot med --check-only alternativet .

Andra alternativ som var tillgängliga tidigare är fortfarande tillgängliga för användning med respektive underkommandon. Separat hjälp för varje underkommando är tillgänglig via -h alternativet eller --help : dotnet new <subcommand> --help visar alla alternativ som stöds för underkommandot.

Dessutom är tabbavslut nu tillgängligt för dotnet new. Den stöder slutförande för installerade mallnamn och för de alternativ som en vald mall tillhandahåller. Information om hur du aktiverar flikslutsättning för .NET SDK finns i Aktivera flikslutsättning.

Exempel på den gamla syntaxen:

  • Visa en lista över alla SPA-mallar (Single Page Application):

    • sedan .NET SDK 6.0.100
    dotnet new --list spa
    • före .NET SDK 6.0.100
    dotnet new spa --list

Argument

  • TEMPLATE_NAME

    Om argumentet anges visas endast mallarna som innehåller <TEMPLATE_NAME> mallnamn eller kortnamn.

Alternativ

  • --author <AUTHOR>

    Filtrerar mallar baserat på mallförfattare. Partiell matchning stöds. Tillgängligt sedan .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Kommaavgränsad lista över kolumner som ska visas i utdata. De kolumner som stöds är:

    • language – En kommaavgränsad lista över språk som stöds av mallen.
    • tags – Listan över malltaggar.
    • author – Mallförfattaren.
    • type – Malltypen: projekt eller objekt.

    Mallnamnet och det korta namnet visas alltid. Standardlistan med kolumner är mallnamn, kort namn, språk och taggar. Den här listan motsvarar att --columns=language,tagsange . Tillgängligt sedan .NET SDK 5.0.300.

  • --columns-all

    Visar alla kolumner i utdata. Tillgängligt sedan .NET SDK 5.0.300.

  • -d|--diagnostics

    Aktiverar diagnostikutdata. Tillgängligt sedan .NET SDK 7.0.100.

  • -h|--help

    Skriver ut hjälp för listkommandot. Tillgängligt sedan .NET SDK 7.0.100.

  • --ignore-constraints

    Inaktiverar kontroll av om mallen uppfyller de begränsningar som ska köras. Tillgängligt sedan .NET SDK 7.0.100.

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

    Filtrerar mallar baserat på språk som stöds av mallen. Det språk som accepteras varierar beroende på mallen. Ogiltigt för vissa mallar.

    Anteckning

    Vissa gränssnitt tolkas # som ett specialtecken. I dessa fall omger du värdet för språkparametern inom citattecken. Till exempel dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Plats för att placera de genererade utdata. Standardvärdet är den aktuella katalogen. För listkommandot kan det vara nödvändigt att ange utdatakatalogen för att korrekt utvärdera begränsningar för mallen. Tillgängligt sedan .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Det projekt som mallen läggs till i. För listkommandot kan det behövas för att ange det projekt som mallen läggs till i för att korrekt utvärdera begränsningar för mallen. Tillgängligt sedan .NET SDK 7.0.100.

  • --tag <TAG>

    Filtrerar mallar baserat på malltaggar. För att väljas måste en mall ha minst en tagg som exakt matchar kriterierna. Tillgängligt sedan .NET SDK 5.0.300.

  • --type <TYPE>

    Filtrerar mallar baserat på malltyp. Fördefinierade värden är project, itemoch solution.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal]och diag[nostic]. Tillgängligt sedan .NET SDK 7.0.100.

Exempel

  • Visa en lista över alla mallar

    dotnet new list

  • Visa en lista över alla SPA-mallar (Single Page Application):

    dotnet new list spa

  • Visa en lista över alla mallar som matchar delsträngen vi .

    dotnet new list we

  • Visa en lista över alla mallar som matchar delsträngen som stöder F#-språket.

    dotnet new list we --language "F#"

  • Visa en lista över alla objektmallar.

    dotnet new list --type item

  • Visa en lista över alla C#-mallar som visar författaren och typen i utdata.

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

Se även