dotnet new list

  • Artículo

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

Nombre

dotnet new list: enumera las plantillas disponibles que se ejecutarán mediante dotnet new.

Sinopsis

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]

Descripción

El comando dotnet new list muestra una lista de las plantillas disponibles para usarlas con dotnet new. Si se especifica <TEMPLATE_NAME>, se enumerarán las plantillas que contengan el nombre especificado. Esta opción enumera solo las plantillas predeterminadas e instaladas. Para buscar plantillas en NuGet que pueda instalar localmente, use el comando search.

A partir del SDK de .NET 7.0.100, es posible que el comando list no muestre todas las plantillas instaladas en la máquina. Tiene en cuenta el resultado de las restricciones de plantilla y no se mostrarán las plantillas que no se puedan usar. Para forzar la presentación de todas las plantillas, use la opción --ignore-constraints.

Nota

A partir del SDK de .NET 7, la sintaxis dotnet new ha cambiado:

  • Las opciones --list, --search, --install y --uninstall se han convertido en los subcomandos list, search, install y uninstall.
  • La opción --update-apply se ha convertido en el subcomando update.
  • Para usar --update-check, utilice el subcomando update con la opción --check-only.

Otras opciones que estaban disponibles antes siguen estando disponibles para su uso con sus respectivos subcomandos. Hay ayuda independiente disponible para cada subcomando mediante la opción -h o --help: dotnet new <subcommand> --help enumera todas las opciones admitidas para el subcomando.

Además, la finalización con tabulación ya está disponible para dotnet new. Admite la finalización de nombres de plantillas instaladas y para las opciones que proporciona una plantilla seleccionada. Para activar la finalización con tabulación para el SDK de .NET, vea Habilitación de la finalización con tabulación.

Ejemplos de la sintaxis anterior:

  • Enumeración de todas las plantillas de aplicación de una sola página (SPA):

    • desde el SDK de .NET 6.0.100
    dotnet new --list spa
    • antes del SDK de .NET 6.0.100
    dotnet new spa --list

Argumentos

  • TEMPLATE_NAME

    Si se especifica el argumento, solo se mostrarán las plantillas que contengan <TEMPLATE_NAME> en el nombre de plantilla o nombre corto.

Opciones

  • --author <AUTHOR>

    Filtra plantillas basándose en el autor de la plantilla. Se admite la coincidencia parcial. Disponible a partir del SDK de .NET 5.0.300.

  • --columns <COLUMNS>

    Lista de columnas separada por comas que se mostrará en la salida. Las columnas admitidas son:

    • language: lista de lenguajes separada por comas compatible con la plantilla.
    • tags: lista de etiquetas de plantilla.
    • author: autor de la plantilla.
    • type: tipo de plantilla, proyecto o elemento.

    El nombre de plantilla y el nombre corto siempre se muestran. La lista predeterminada de columnas es el nombre de plantilla, el nombre corto, el idioma y las etiquetas. Esta lista es equivalente a especificar --columns=language,tags. Disponible a partir del SDK de .NET 5.0.300.

  • --columns-all

    Muestra todas las columnas en la salida. Disponible a partir del SDK de .NET 5.0.300.

  • -d|--diagnostics

    Habilita la salida de diagnóstico. Disponible a partir del SDK de .NET 7.0.100.

  • -h|--help

    Imprime la ayuda para el comando list. Disponible a partir del SDK de .NET 7.0.100.

  • --ignore-constraints

    Deshabilita la comprobación de si la plantilla cumple las restricciones que se van a ejecutar. Disponible a partir del SDK de .NET 7.0.100.

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

    Filtra plantillas basadas en el lenguaje compatible con la plantilla. El lenguaje aceptado varía en función de la plantilla. No es válido para algunas plantillas.

    Nota

    Algunos shells interpretan # como un carácter especial. En esos casos, incluya el valor del parámetro de lenguaje entre comillas. Por ejemplo: dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    La ubicación para colocar la salida generada. El valor predeterminado es el directorio actual. Para el comando list, puede que sea necesario especificar el directorio de salida a fin de evaluar correctamente las restricciones de la plantilla. Disponible a partir del SDK de .NET 7.0.100.

  • --project <PROJECT_PATH>

    Proyecto al que se agrega la plantilla. Para el comando list, es posible que sea necesario especificar el proyecto al que se agrega la plantilla a fin de evaluar correctamente las restricciones de la plantilla. Disponible a partir del SDK de .NET 7.0.100.

  • --tag <TAG>

    Filtra plantillas basadas en etiquetas de plantilla. Para seleccionarla, una plantilla debe tener al menos una etiqueta que coincida exactamente con los criterios. Disponible a partir del SDK de .NET 5.0.300.

  • --type <TYPE>

    Filtra plantillas basadas en el tipo de plantilla. Los valores predefinidos son project, item y solution.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal] y diag[nostic]. Disponible a partir del SDK de .NET 7.0.100.

Ejemplos

  • Enumeración de todas las plantillas

    dotnet new list

  • Enumeración de todas las plantillas de aplicación de una sola página (SPA):

    dotnet new list spa

  • Enumeración de todas las plantillas que coinciden con la subcadena we.

    dotnet new list we

  • Enumere todas las plantillas que coinciden con la subcadena we que admite el lenguaje F#.

    dotnet new list we --language "F#"

  • Enumeración de todas las plantillas de elemento.

    dotnet new list --type item

  • Enumeración de todas las plantillas de C#, que muestran el autor y el tipo en la salida.

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

Vea también