Delen via


dotnet nieuwe lijst

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Naam

dotnet new list- Hiermee worden de beschikbare sjablonen weergegeven die moeten worden uitgevoerd met .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]

Beschrijving

De dotnet new list opdracht bevat een lijst met beschikbare sjablonen voor gebruik met dotnet new. Als de <TEMPLATE_NAME> is opgegeven, worden sjablonen weergegeven die de opgegeven naam bevatten. Met deze optie worden alleen standaardsjablonen en geïnstalleerde sjablonen weergegeven. Als u in NuGet sjablonen wilt vinden die u lokaal kunt installeren, gebruikt u de search opdracht .

Vanaf .NET SDK 7.0.100 worden met de list opdracht mogelijk niet alle sjablonen weergegeven die op de computer zijn geïnstalleerd. Er wordt rekening gehouden met het resultaat van sjabloonbeperkingen en de sjablonen die niet kunnen worden gebruikt, worden niet weergegeven. Gebruik de --ignore-constraints optie om de weergave van alle sjablonen af te dwingen.

Notitie

Vanaf de .NET 7 SDK is de dotnet new syntaxis gewijzigd:

  • De --listopties , --search, --installen --uninstall werden listsubopdrachten , search, installen uninstall .
  • De --update-apply optie is de update subopdracht geworden.
  • Als u wilt gebruiken --update-check, gebruikt u de update subopdracht met de --check-only optie.

Andere opties die eerder beschikbaar waren, zijn nog steeds beschikbaar voor gebruik met hun respectieve subopdrachten. Afzonderlijke help voor elke subopdracht is beschikbaar via de -h optie of --help : dotnet new <subcommand> --help bevat alle ondersteunde opties voor de subopdracht.

Daarnaast is het voltooien van tabbladen nu beschikbaar voor dotnet new. Het ondersteunt voltooiing voor geïnstalleerde sjabloonnamen en voor de opties die een geselecteerde sjabloon biedt. Zie Voltooiing van tabbladen inschakelen om tabvoltooiing voor de .NET SDK te activeren.

Voorbeelden van de oude syntaxis:

  • Alle SPA-sjablonen (Single Page Application) weergeven:

    • sinds .NET SDK 6.0.100
    dotnet new --list spa
    
    • vóór .NET SDK 6.0.100
    dotnet new spa --list
    

Argumenten

  • TEMPLATE_NAME

    Als het argument is opgegeven, worden alleen de sjablonen met <TEMPLATE_NAME> sjabloonnaam of korte naam weergegeven.

Opties

  • --author <AUTHOR>

    Filtert sjablonen op basis van sjabloonauteur. Gedeeltelijke overeenkomst wordt ondersteund. Beschikbaar sinds .NET SDK 5.0.300.

  • --columns <COLUMNS>

    Door komma's gescheiden lijst met kolommen die moeten worden weergegeven in de uitvoer. De ondersteunde kolommen zijn:

    • language - Een door komma's gescheiden lijst met talen die door de sjabloon worden ondersteund.
    • tags - De lijst met sjabloontags.
    • author - De auteur van de sjabloon.
    • type - Het sjabloontype: project of item.

    De sjabloonnaam en de korte naam worden altijd weergegeven. De standaardlijst met kolommen is sjabloonnaam, korte naam, taal en tags. Deze lijst is gelijk aan het opgeven van --columns=language,tags. Beschikbaar sinds .NET SDK 5.0.300.

  • --columns-all

    Geeft alle kolommen in de uitvoer weer. Beschikbaar sinds .NET SDK 5.0.300.

  • -d|--diagnostics

    Hiermee schakelt u diagnostische uitvoer in. Beschikbaar sinds .NET SDK 7.0.100.

  • -h|--help

    Hiermee wordt de help voor de lijstopdracht afgedrukt. Beschikbaar sinds .NET SDK 7.0.100.

  • --ignore-constraints

    Hiermee schakelt u controleren of de sjabloon voldoet aan de beperkingen die moeten worden uitgevoerd. Beschikbaar sinds .NET SDK 7.0.100.

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

    Hiermee filtert u sjablonen op basis van de taal die door de sjabloon wordt ondersteund. De taal die wordt geaccepteerd, verschilt per sjabloon. Niet geldig voor sommige sjablonen.

    Notitie

    Sommige shells interpreteren # als een speciaal teken. In die gevallen plaatst u de waarde van de taalparameter tussen aanhalingstekens. Bijvoorbeeld dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Locatie voor het plaatsen van de gegenereerde uitvoer. De standaardwaarde is de huidige map. Voor de lijstopdracht kan het nodig zijn om de uitvoermap op te geven om de beperkingen voor de sjabloon correct te evalueren. Beschikbaar sinds .NET SDK 7.0.100.

  • --project <PROJECT_PATH>

    Het project waaraan de sjabloon wordt toegevoegd. Voor de lijstopdracht kan het nodig zijn om het project op te geven waaraan de sjabloon wordt toegevoegd om de beperkingen voor de sjabloon correct te evalueren. Beschikbaar sinds .NET SDK 7.0.100.

  • --tag <TAG>

    Filtert sjablonen op basis van sjabloontags. Om te kunnen worden geselecteerd, moet een sjabloon ten minste één tag hebben die exact overeenkomt met de criteria. Beschikbaar sinds .NET SDK 5.0.300.

  • --type <TYPE>

    Hiermee filtert u sjablonen op basis van sjabloontype. Vooraf gedefinieerde waarden zijn project, itemen solution.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijn q[uiet], m[inimal], n[ormal]en diag[nostic]. Beschikbaar sinds .NET SDK 7.0.100.

Voorbeelden

  • Alle sjablonen weergeven

    dotnet new list
    
  • Alle SPA-sjablonen (Single Page Application) weergeven:

    dotnet new list spa
    
  • Maak een lijst met alle sjablonen die overeenkomen met de we-subtekenreeks.

    dotnet new list we
    
  • Maak een lijst met alle sjablonen die overeenkomen met de subtekenreeks we die ondersteuning bieden voor de F#-taal.

    dotnet new list we --language "F#"
    
  • Alle itemsjablonen weergeven.

    dotnet new list --type item
    
  • Alle C#-sjablonen weergeven met de auteur en het type in de uitvoer.

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

Zie ook