dotnet new search

  • Artículo

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

Nombre

dotnet new search: busca las plantillas compatibles con dotnet new en NuGet.org.

Sinopsis

dotnet new search <TEMPLATE_NAME>

dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
    [--columns <COLUMNS>] [--columns-all]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Descripción

El comando dotnet new search busca plantillas compatibles con dotnet new en NuGet.org. Cuando se especifica <NOMBRE_DE_PLANTILLA>, busca plantillas que contengan el nombre especificado.

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:

  • Buscar todas las plantillas disponibles en NuGet.org que coincidan con la subcadena "we" y admitan el lenguaje F#.

    dotnet new we --search --language "F#"

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. El argumento es obligatorio cuando no se especifican las opciones --author, --language, --package, --tag o --type.

    Nota

    A partir del SDK de .NET 6.0.100, puede colocar el argumento <TEMPLATE_NAME> después de la opción --search. Por ejemplo, dotnet new --search web proporciona el mismo resultado que dotnet new web --search. No se permite el uso de más de un argumento.

Opciones

  • --author <AUTHOR>

    Filtra plantillas basándose en el autor de la plantilla. Se admite la coincidencia parcial.

  • --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: el tipo de plantilla: proyecto o elemento.

    Siempre se muestran el nombre de plantilla, nombre corto, nombre del paquete y número total de descargas. La lista de columnas predeterminada es el nombre de plantilla, nombre corto, autor, lenguaje, paquete y descargas totales. Esta lista es equivalente a especificar --columns=author,language.

  • --columns-all

    Muestra todas las columnas en la salida.

  • -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 search. 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 --search --language "F#".

  • --package <PACKAGE>

    Filtra plantillas basadas en el id. del paquete NuGet. Se admite la coincidencia parcial.

  • --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.

  • --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.

Nota

Para asegurarse de que el paquete de plantillas aparece en el resultado de dotnet new --search, establezca el tipo de paquete NuGet en Template.

Ejemplos

  • Busque todas las plantillas disponibles en NuGet.org que coincidan con la subcadena spa.

    dotnet new search spa

  • Busque todas las plantillas disponibles en NuGet.org que coincidan con la subcadena we y admitan el lenguaje F#.

    dotnet new search we --language "F#"

  • Busque plantillas de elemento.

    dotnet new search --type item

  • Busque todas las plantillas de C#, mostrando el tipo y las etiquetas en la salida.

    dotnet new search --language "C#" --columns "type,tags"

Vea también