Leer en inglés

Compartir vía

Plantillas predeterminadas de .NET para dotnet new

  • Artículo

Cuando instala el SDK de .NET, recibe más de una docena de plantillas integradas para crear proyectos y archivos, incluidas aplicaciones de consola, bibliotecas de clases, proyectos de prueba unitaria, aplicaciones de ASP.NET Core (incluidos los proyectos Angular y React) y archivos de configuración. Para enumerar las plantillas integradas, ejecute el comando dotnet new list:

CLI de .NET 
dotnet new list

En la tabla siguiente se muestran las plantillas que vienen preinstaladas con el SDK de .NET. El lenguaje predeterminado de la plantilla se muestra entre corchetes. Haga clic en el vínculo del nombre corto para ver las opciones específicas de la plantilla.

Plantillas Nombre corto Lenguaje Etiquetas Inclusión
Aplicación de consola console [C#], F#, VB Común/Consola 1.0
Biblioteca de clases classlib [C#], F#, VB Común/Biblioteca 1.0
Aplicación WPF wpf [C#], VB Común/WPF 3.0 (5.0 para VB)
Biblioteca de clases de WPF wpflib [C#], VB Común/WPF 3.0 (5.0 para VB)
Biblioteca de controles personalizados WPF wpfcustomcontrollib [C#], VB Común/WPF 3.0 (5.0 para VB)
Biblioteca de controles de usuario de WPF wpfusercontrollib [C#], VB Común/WPF 3.0 (5.0 para VB)
Aplicación de Windows Forms (WinForms) winforms [C#], VB Común/WinForms 3.0 (5.0 para VB)
Biblioteca de clases de Windows Forms (WinForms) winformslib [C#], VB Común/WinForms 3.0 (5.0 para VB)
Servicio Worker worker [C#] Común/Worker/Web 3,0
Proyecto de prueba de MSTest mstest [C#], F#, VB Prueba/MSTest 1.0
MsTest Test (clase) mstest-class [C#], F#, VB Prueba/MSTest 1.0
Proyecto de prueba de NUnit 3 nunit [C#], F#, VB Prueba/NUnit 2.1.400
Elemento de prueba de NUnit 3 nunit-test [C#], F#, VB Prueba/NUnit 2.2
Proyecto de prueba de xUnit xunit [C#], F#, VB Prueba/xUnit 1.0
Componente Razor razorcomponent [C#] Web/ASP.NET 3.0
Página de Razor page [C#] Web/ASP.NET 2.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0
Blazor Aplicación web blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly Aplicación independiente blazorwasm [C#] Web/Blazor//WebAssemblyPWA 3.1.300
Vacío de ASP.NET Core web [C#], F# Web/Vacío 1.0
Aplicación web de ASP.NET Core (Model-View-Controller) mvc [C#], F# Web/MVC 1.0
Aplicación web de ASP.NET Core webapp, razor [C#] Web/MVC/Razor Pages 2.2, 2.0
Biblioteca de clases de Razor razorclasslib [C#] Web/Razor/Biblioteca/Biblioteca de clases de Razor 2.1
API web de ASP.NET Core webapi [C#], F# Web/Web API/API/Service/WebAPI 1.0
API de ASP.NET Core webapiaot [C#] Web/Web API/API/Service 8.0
controlador de API de ASP.NET Core apicontroller [C#] Web/ASP.NET 8.0
Servicio gRPC de ASP.NET Core grpc [C#] Web/gRPC 3.0
Archivo dotnet gitignore gitignore Configuración 3.0
archivo global.json globaljson Configuración 2.0
Configuración de NuGet nugetconfig Configuración 1.0
Archivo de manifiesto de la herramienta local dotnet tool-manifest Configuración 3.0
Configuración web webconfig Configuración 1.0
Archivo de solución sln Soluciones 1.0
Archivo de búfer de protocolo proto Web/gRPC 3.0
Archivo EditorConfig editorconfig Configuración 6,0

En la tabla siguiente se muestran las plantillas que se han descontinuado y que ya no están preinstaladas con el SDK de .NET. Haga clic en el vínculo del nombre corto para ver las opciones específicas de la plantilla.

Plantillas Nombre corto Lenguaje Etiquetas Descontinuado desde
ASP.NET Core con Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core con React.js react [C#] Web/MVC/SPA 8.0
Blazor Aplicación de servidor blazorserver [C#] Web/Blazor 8.0
Blazor Aplicación de servidor vacía blazorserver-empty [C#] Web/Blazor 8.0
BlazorWebAssembly Aplicación vacía blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Opciones de plantilla

Cada plantilla puede tener opciones adicionales disponibles. Para mostrar las opciones adicionales disponibles para la plantilla, use la opción --help con el argumento template name, por ejemplo, dotnet new console --help. En caso de que la plantilla admita varios idiomas, este comando mostrará ayuda para la plantilla en el idioma predeterminado. Al combinarlo con la opción --language, puede ver la ayuda para otros idiomas: dotnet new console --help --language F#. Las plantillas que se incluyen con el SDK de .NET tienen las siguientes opciones adicionales:

console

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Disponible desde el SDK de .NET Core 3.0.

    En la tabla siguiente se enumeran los valores predeterminados según la versión del SDK en uso:

    Versión del SDK Valor predeterminado
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    3.1 netcoreapp3.1

    La capacidad de crear un proyecto para un TFM anterior depende de tener instalada esa versión del SDK. Por ejemplo, si solo tiene instalado SDK de .NET 7, el único valor disponible para --framework será net7.0. Si instala el SDK de .NET 6, el valor net6.0 estará disponible para --framework. Si instala el SDK de .NET Core 3.1, netcoreapp3.1 estará disponible, y así sucesivamente. Por lo tanto, al especificar --framework netcoreapp3.1 puede tener .NET Core 3.1 como destino incluso mientras se ejecuta dotnet new en el SDK de .NET 6.

    Como alternativa, es posible que pueda instalar el paquete NuGet para la plantilla a fin de crear un proyecto que tenga como destino un marco anterior al SDK que está usando. Los tipos de proyectos common, web y SPA usan paquetes diferentes por moniker de la plataforma de destino (TFM). Por ejemplo, para crear un proyecto console que tenga como destino netcoreapp1.0, ejecute dotnet new install en Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3. No es compatible con F#. Disponible a partir del SDK de .NET Core 2.2.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.

  • --no-restore

    Si se especifica, no se ejecuta ninguna restauración implícita durante la creación del proyecto. Disponible a partir del SDK de .NET Core 2.2.

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false. Solo está disponible para C#.

classlib

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Valores: net8.0, net7.0o net6.0 para crear una biblioteca de clases de .NET o netstandard2.1 netstandard2.0 para crear una biblioteca de clases estándar de .NET. El valor predeterminado para el SDK de .NET 8.0.x es net8.0.

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3. No es compatible con F#. Disponible a partir del SDK de .NET Core 2.2.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

wpf, wpflib, , wpfcustomcontrollib, wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Para el SDK de .NET 8, el valor predeterminado es net8.0. Disponible a partir del SDK de .NET Core 3.1.

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. El valor predeterminado para el SDK de .NET 8 es net8.0. Disponible a partir del SDK de .NET Core 3.1.

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

mstest

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Opción disponible a partir del SDK de .NET Core 3.0.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

La capacidad de crear un proyecto para un TFM anterior depende de tener instalada esa versión del SDK. Por ejemplo, si solo tiene instalado SDK de .NET 6, el único valor disponible para --framework será net6.0. Si instala el SDK de .NET 5, el valor net5.0 estará disponible para --framework. Si instala el SDK de .NET Core 3.1, netcoreapp3.1 estará disponible, y así sucesivamente. Por lo tanto, al especificar --framework netcoreapp3.1 puede tener .NET Core 3.1 como destino incluso mientras se ejecuta dotnet new en el SDK de .NET 6.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --sdk

    Use el estilo de proyecto MSTest.Sdk.

  • --test-runner <TEST_RUNNER>

    Ejecutor o plataforma del proyecto de prueba. Los valores posibles son:

    • VSTest - Plataforma VSTest (valor predeterminado).
    • MSTest - MSTest Runner (es decir, Microsoft.Testing.Platform).

  • --coverage-tool <COVERAGE_TOOL>

    Herramienta de cobertura que se va a usar para el proyecto de prueba. Los valores posibles son:

    • Microsoft.CodeCoverage - Cobertura de código de Microsoft (valor predeterminado).
    • coverlet - Herramienta de cobertura de coverlet.

  • --extensions-profile <EXTENSIONS_PROFILE>

    El perfil de extensiones del SDK al usar MSTest Runner. Los valores posibles son:

    • Default - Perfil de extensiones predeterminado (valor predeterminado).
    • None: no hay extensiones habilitadas.
    • AllMicrosoft: habilita todas las extensiones suministradas por Microsoft (incluidas las extensiones con una licencia restrictiva).

  • --fixture <FIXTURE>

    Los tipos de accesorio que se van a incluir en el proyecto de prueba. Los valores posibles son:

    • None - Sin métodos de accesorio.
    • AssemblyInitialize - Método de accesorio AssemblyInitialize.
    • AssemblyCleanup - Método de accesorio AssemblyCleanup.
    • ClassInitialize - Método de accesorio ClassInitialize.
    • ClassCleanup - Método de accesorio ClassCleanup.
    • TestInitialize - Método de accesorio TestInitialize.
    • TestCleanup - Método de accesorio TestCleanup.

    Donde se permiten varios valores.

  • -p|--enable-pack

    Habilita el empaquetado del proyecto mediante dotnet pack.

mstest-class

  • --fixture <FIXTURE>

    Los tipos de accesorio que se van a incluir en el proyecto de prueba. Los valores posibles son:

    • None - Sin métodos de accesorio.
    • AssemblyInitialize - Método de accesorio AssemblyInitialize.
    • AssemblyCleanup - Método de accesorio AssemblyCleanup.
    • ClassInitialize - Método de accesorio ClassInitialize.
    • ClassCleanup - Método de accesorio ClassCleanup.
    • TestInitialize - Método de accesorio TestInitialize.
    • TestCleanup - Método de accesorio TestCleanup.

    Donde se permiten varios valores.

xunit

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Opción disponible a partir del SDK de .NET Core 3.0.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

La capacidad de crear un proyecto para un TFM anterior depende de tener instalada esa versión del SDK. Por ejemplo, si solo tiene instalado SDK de .NET 6, el único valor disponible para --framework será net6.0. Si instala el SDK de .NET 5, el valor net5.0 estará disponible para --framework. Si instala el SDK de .NET Core 3.1, netcoreapp3.1 estará disponible, y así sucesivamente. Por lo tanto, al especificar --framework netcoreapp3.1 puede tener .NET Core 3.1 como destino incluso mientras se ejecuta dotnet new en el SDK de .NET 6.

  • -p|--enable-pack

    Habilita el empaquetado del proyecto mediante dotnet pack.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

nunit

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

La capacidad de crear un proyecto para un TFM anterior depende de tener instalada esa versión del SDK. Por ejemplo, si solo tiene instalado SDK de .NET 6, el único valor disponible para --framework será net6.0. Si instala el SDK de .NET 5, el valor net5.0 estará disponible para --framework. Si instala el SDK de .NET Core 3.1, netcoreapp3.1 estará disponible, y así sucesivamente. Por lo tanto, al especificar --framework netcoreapp3.1 puede tener .NET Core 3.1 como destino incluso mientras se ejecuta dotnet new en el SDK de .NET 6.

  • -p|--enable-pack

    Habilita el empaquetado del proyecto mediante dotnet pack.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

page

  • -na|--namespace <NAMESPACE_NAME>

    Espacio de nombres del código generado. El valor predeterminado es MyApp.Namespace.

  • -np|--no-pagemodel

    Crea la página sin PageModel.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Espacio de nombres del código generado. El valor predeterminado es MyApp.Namespace.

blazorserver

Se ha interrumpido desde el SDK de .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar. Los valores posibles son:

    • None: sin autenticación (valor predeterminado).
    • Individual: autenticación individual.
    • IndividualB2C: autenticación individual con Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino. Los inquilinos del id. externo de Entra también usan SingleOrg.
    • MultiOrg: autenticación organizativa para varios inquilinos.
    • Windows: autenticación de Windows.

  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión. Úsela con la autenticación IndividualB2C. El valor predeterminado es https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto. Úsela con la autenticación IndividualB2C.

  • -rp|--reset-password-policy-id <ID>

    Identificador de la directiva de restablecimiento de contraseñas de este proyecto. Úsela con la autenticación IndividualB2C.

  • -ep|--edit-profile-policy-id <ID>

    Identificador de la directiva de edición de perfiles de este proyecto. Úsela con la autenticación IndividualB2C.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión. Úsela con las autenticaciones SingleOrg o MultiOrg. El valor predeterminado es https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto. Úsela con las autenticaciones IndividualB2C, SingleOrg o MultiOrg. El valor predeterminado es 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es qualified.domain.name.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión. Úsela con la autenticación SingleOrg. El valor predeterminado es 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Ruta de acceso de solicitud de la ruta de acceso de la base de la aplicación del URI de redirección. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es /signin-oidc.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio. Solo se aplica a las autenticaciones SingleOrg y MultiOrg.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • --no-https

    Desactiva HTTPS. Esta opción solo se aplica si no se usan Individual, IndividualB2C, SingleOrg o MultiOrg en --auth.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --kestrelHttpPort

    Número de puerto que se usará para el punto de conexión HTTP en launchSettings.json

  • --kestrelHttpsPort

    Número de puerto que se usará para el punto de conexión HTTPS en launchSettings.json Esta opción no es aplicable si se usa el parámetro no-https (pero se omite no-https cuando se elige una configuración de autenticación individual u organizativa para --auth).

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

blazor

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.

    Esta plantilla está disponible para .NET 8 o posterior.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --exclude-launch-settings

    Excluye launchSettings.json de la aplicación generada.

  • -int|--interactivity <None|Server|Webassembly|Auto >

    Especifica el modo de representación interactiva que se va a usar para los componentes interactivos. Los valores posibles son:

    • None - Sin interactividad (solo representación estática del lado servidor).
    • Server - (Valor predeterminado) Ejecuta la aplicación en el servidor con representación interactiva del lado servidor.
    • WebAssembly - Ejecuta la aplicación mediante la representación del lado cliente en el explorador con WebAssembly.
    • Auto - Usa la representación interactiva del lado servidor al descargar la agrupación Blazor y activar el entorno de ejecución Blazor en el cliente y, a continuación, usa la representación del lado cliente con WebAssembly.

  • --empty

    Omite las páginas de ejemplo y el estilo que muestran patrones de uso básicos.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar. Los valores posibles son:

    • None: sin autenticación (valor predeterminado).
    • Individual: autenticación individual.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite. Solo se aplica a la autenticación Individual.

  • -ai|--all-interactive

    Hace que cada página sea interactiva aplicando un modo de representación interactivo en el nivel superior. Si es false, las páginas usan la representación estática del lado servidor de forma predeterminada y se pueden marcar como interactivas por página o por componente. Esta opción solo es efectiva si la opción -i|--interactivity no está establecida en None.

  • --no-https

    Desactiva HTTPS. Esta opción solo se aplica si Individual no se elige para la opción -au|--auth.

  • --use-program-main

    Si se especifica, se usará una clase Program y un método Main explícitos en lugar de instrucciones de nivel superior.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • -ho|--hosted

    Incluye un host de ASP.NET Core para la aplicación BlazorWebAssembly.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar. Los valores posibles son:

    • None: sin autenticación (valor predeterminado).
    • Individual: autenticación individual.
    • IndividualB2C: autenticación individual con Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino. Los inquilinos de id. externo de Entra también usan SingleOrg.

  • --authority <AUTHORITY>

    La autoridad del proveedor de OIDC. Úsela con la autenticación Individual. El valor predeterminado es https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión. Úsela con la autenticación IndividualB2C. El valor predeterminado es https://aadB2CInstance.b2clogin.com/.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto. Úsela con la autenticación IndividualB2C.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión. Úsela con la autenticación SingleOrg. El valor predeterminado es https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto. Úselo con la autenticación IndividualB2C, SingleOrg o Individual en escenarios independientes. El valor predeterminado es 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es qualified.domain.name.

  • --app-id-uri <URI>

    El URI del id. de la aplicación de la API de servidor a la que quiere llamar. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es api.id.uri.

  • --api-client-id <ID>

    El id. de cliente de la API que el servidor hospeda. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es 11111111-1111-1111-11111111111111111.

  • -s|--default-scope <SCOPE>

    El ámbito de la API que el cliente debe solicitar para aprovisionar un token de acceso. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es user_impersonation.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión. Úsela con la autenticación SingleOrg. El valor predeterminado es 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio. Solo se aplica a la autenticación SingleOrg.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • -p|--pwa

    Genera una aplicación web progresiva (PWA) que admite la instalación y el uso sin conexión.

  • --no-https

    Desactiva HTTPS. Esta opción solo se aplica si no se usan Individual, IndividualB2C o SingleOrg en --auth.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C.

  • --called-api-url <URL>

    Dirección URL de la API que se va a llamar desde la aplicación web. Solo se aplica a la autenticación SingleOrg o IndividualB2C sin un host especificado de ASP.NET Core. El valor predeterminado es https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Especifica si la aplicación web llama a Microsoft Graph. Solo se aplica a la autenticación SingleOrg.

  • --called-api-scopes <SCOPES>

    Ámbitos para solicitar llamar a la API desde la aplicación web. Solo se aplica a la autenticación SingleOrg o IndividualB2C sin un host especificado de ASP.NET Core. De manera predeterminada, es user.read.

  • --kestrelHttpPort

    Número de puerto que se usará para el punto de conexión HTTP en launchSettings.json

  • --kestrelHttpsPort

    Número de puerto que se usará para el punto de conexión HTTPS en launchSettings.json Esta opción no es aplicable si se usa el parámetro no-https (pero se omite no-https cuando se elige una configuración de autenticación individual u organizativa para --auth).

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

web

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Opción no disponible en el SDK de .NET Core 2.2.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --no-https

    Desactiva HTTPS.

  • --kestrelHttpPort

    Número de puerto que se usará para el punto de conexión HTTP en launchSettings.json

  • --kestrelHttpsPort

    Número de puerto que se usará para el punto de conexión HTTPS en launchSettings.json Esta opción no es aplicable si se usa el parámetro no-https (pero se omite no-https cuando se elige una configuración de autenticación individual u organizativa para --auth).

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar. Los valores posibles son:

    • None: sin autenticación (valor predeterminado).
    • Individual: autenticación individual.
    • IndividualB2C: autenticación individual con Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino. Los inquilinos de id. externo de Entra también usan SingleOrg.
    • MultiOrg: autenticación organizativa para varios inquilinos.
    • Windows: autenticación de Windows.

  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión. Úsela con la autenticación IndividualB2C. El valor predeterminado es https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto. Úsela con la autenticación IndividualB2C.

  • -rp|--reset-password-policy-id <ID>

    Identificador de la directiva de restablecimiento de contraseñas de este proyecto. Úsela con la autenticación IndividualB2C.

  • -ep|--edit-profile-policy-id <ID>

    Identificador de la directiva de edición de perfiles de este proyecto. Úsela con la autenticación IndividualB2C.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión. Úsela con las autenticaciones SingleOrg o MultiOrg. El valor predeterminado es https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto. Úsela con las autenticaciones IndividualB2C, SingleOrg o MultiOrg. El valor predeterminado es 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es qualified.domain.name.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión. Úsela con la autenticación SingleOrg. El valor predeterminado es 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Ruta de acceso de solicitud de la ruta de acceso de la base de la aplicación del URI de redirección. Úsela con las autenticaciones SingleOrg o IndividualB2C. El valor predeterminado es /signin-oidc.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio. Solo se aplica a las autenticaciones SingleOrg y MultiOrg.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • --no-https

    Desactiva HTTPS. Esta opción solo se aplica si no se usan Individual, IndividualB2C, SingleOrg o MultiOrg.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Opción disponible a partir del SDK de .NET Core 3.0.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --use-browserlink

    Incluye BrowserLink en el proyecto. Opción no disponible en el SDK de .NET Core 2.2 y 3.1.

  • -rrc|--razor-runtime-compilation

    Determina si el proyecto está configurado para usar la compilación en tiempo de ejecución de Razor en las compilaciones de depuración. Opción disponible a partir del SDK de .NET Core 3.1.201.

  • --kestrelHttpPort

    Número de puerto que se usará para el punto de conexión HTTP en launchSettings.json

  • --kestrelHttpsPort

    Número de puerto que se usará para el punto de conexión HTTPS en launchSettings.json Esta opción no es aplicable si se usa el parámetro no-https (pero se omite no-https cuando se elige una configuración de autenticación individual u organizativa para --auth).

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

angular, react

Se ha interrumpido desde el SDK de .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar. Disponible desde el SDK de .NET Core 3.0.

    Los valores posibles son:

    • None: sin autenticación (valor predeterminado).
    • Individual: autenticación individual.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --no-https

    Desactiva HTTPS. Esta opción solo se aplica si la autenticación es None.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C. Disponible desde el SDK de .NET Core 3.0.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Opción no disponible en el SDK de .NET Core 2.2.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Nota

    No hay ninguna plantilla de React para net8.0; sin embargo, si le interesa desarrollar aplicaciones React con ASP.NET Core, consulte Introducción a las aplicaciones de página única (SPA) en ASP.NET Core.

    Versión del SDK Valor predeterminado
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.0

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --kestrelHttpPort

    Número de puerto que se usará para el punto de conexión HTTP en launchSettings.json

  • --kestrelHttpsPort

    Número de puerto que se usará para el punto de conexión HTTPS en launchSettings.json Esta opción no es aplicable si se usa el parámetro no-https (pero se omite no-https cuando se elige una configuración de autenticación individual u organizativa para --auth).

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

razorclasslib

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • -s|--support-pages-and-views

    Permite agregar vistas y páginas de Razor tradicionales además de los componentes a esta biblioteca. Disponible desde el SDK de .NET Core 3.0.

webapiaot

Crea un proyecto de API web con la publicación de AOT habilitada. Para obtener más información, consulte Implementación nativa de AOT y Plantilla de API web (AOT nativa).

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    8.0 net8.0

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar. Los valores posibles son:

    • None: sin autenticación (valor predeterminado).
    • IndividualB2C: autenticación individual con Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino. Los inquilinos de id. externo de Entra también usan SingleOrg.
    • Windows: autenticación de Windows.

  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión. Úsela con la autenticación IndividualB2C. El valor predeterminado es https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Cree un proyecto que use la API mínima de ASP.NET Core. El valor predeterminado es false, pero esta opción se invalida mediante -controllers. Dado que el valor predeterminado para -controllers es false, al escribir dotnet new webapi sin especificar ninguna opción se crea un proyecto de API mínimo.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto. Úsela con la autenticación IndividualB2C.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión. Úsela con la autenticación SingleOrg. El valor predeterminado es https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto. Úsela con las autenticaciones IndividualB2C o SingleOrg. El valor predeterminado es 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Si se deben usar controladores en lugar de API mínimas. Si se especifican esta opción y -minimal, esta opción invalida el valor especificado por -minimal. El valor predeterminado es false. Disponible a partir del SDK de .NET 8.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio. Úsela con las autenticaciones IndividualB2C o SingleOrg. El valor predeterminado es qualified.domain.name.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión. Úsela con la autenticación SingleOrg. El valor predeterminado es 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio. Solo se aplica a la autenticación SingleOrg.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.

  • --no-openapi

    Desactiva la compatibilidad con OpenAPI (Swagger). No se llama a AddSwaggerGen, UseSwagger ni UseSwaggerUI.

  • --no-https

    Desactiva HTTPS. No se crea ningún perfil de inicio https en launchSettings.json. app.UseHsts y app.UseHttpsRedirection no se llaman en Program.cs/Startup.cs. Esta opción solo se aplica si no se usan IndividualB2C o SingleOrg en la autenticación.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite. Solo se aplica a la autenticación IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino. Opción no disponible en el SDK de .NET Core 2.2.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:

    Versión del SDK Valor predeterminado
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    Para crear un proyecto que tenga como destino un marco anterior al SDK que está usando, consulte --framework para proyectos console más arriba en este mismo artículo.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.

  • --use-program-main

    Si se especifica, se usará una clase y Program un método Main explícitos en lugar de instrucciones de nivel superior. Disponible a partir del SDK de .NET 6.0.300 Valor predeterminado: false.

apicontroller

Controlador de API con o sin acciones de lectura y escritura.

  • -p:n|--name <NAME>

    El espacio de nombres para el código generado. El valor predeterminado es MyApp.Namespace.

  • -ac|--actions

    Cree un controlador con acciones de lectura y escritura. El valor predeterminado es false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    Especifica la versión del SDK de .NET que se va a usar en el archivo global.json.

  • --roll-forward <ROLL_FORWARD_POLICY>

    Directiva de puesta al día que se va a usar al seleccionar una versión del SDK, ya sea como reserva si falta una versión específica del SDK o como directiva para usar una versión posterior. Para más información, consulte global-json.

editorconfig

Crea un archivo .editorconfig para configurar las preferencias de estilo del código.

  • --empty

    Crea un objeto .editorconfig vacío, en lugar de los valores predeterminados de .NET.

Vea también