Modelos padrão do .NET para dotnet new

  • Artigo

Ao instalar o SDK do .NET, você recebe dezenas de modelos internos para criar projetos e arquivos, incluindo aplicativos de console, bibliotecas de classes, projetos de teste de unidade, aplicativos ASP.NET Core (incluindo projetos Angular e React) e arquivos de configuração. Para listar os modelos internos, execute o comando dotnet new list:

dotnet new list

A tabela a seguir mostra os modelos que vêm pré-instalados com o SDK do .NET. O idioma padrão do modelo é mostrado entre parênteses. Clique no link de nome curto para ver as opções de modelo específicas.

Modelos Nome curto Idioma Marcas Introduzida
Aplicativo do Console console [C#], F#, VB Comum/Console 1,0
Biblioteca de classes classlib [C#], F#, VB Comum/Library 1,0
Aplicativo WPF wpf [C#], VB Comum/WPF 3.0 (5.0 para VB)
Biblioteca de classes do WPF wpflib [C#], VB Comum/WPF 3.0 (5.0 para VB)
Biblioteca de Controles Personalizados do WPF wpfcustomcontrollib [C#], VB Comum/WPF 3.0 (5.0 para VB)
Biblioteca de controle de usuário WPF wpfusercontrollib [C#], VB Comum/WPF 3.0 (5.0 para VB)
Aplicativo do WinForms (Windows Forms) winforms [C#], VB Comum/WinForms 3.0 (5.0 para VB)
Biblioteca de classes do WinForms (Windows Forms) winformslib [C#], VB Comum/WinForms 3.0 (5.0 para VB)
Serviço de trabalho worker [C#] Comum/trabalho/Web 3,0
Projeto de Teste de Unidade mstest [C#], F#, VB Teste/MSTest 1,0
Projeto de Teste do NUnit 3 nunit [C#], F#, VB Teste/NUnit 2.1.400
Item de Teste do NUnit 3 nunit-test [C#], F#, VB Teste/NUnit 2,2
Projeto de Teste xUnit xunit [C#], F#, VB Teste/xUnit 1,0
Componente do Razor razorcomponent [C#] Web/ASP.NET 3,0
Página do Razor page [C#] Web/ASP.NET 2,0
Importações de Exibição do MVC viewimports [C#] Web/ASP.NET 2,0
MVC ViewStart viewstart [C#] Web/ASP.NET 2,0
Aplicativo Web Blazor blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly Aplicativo autônomo blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
ASP.NET Core Vazio web [C#], F# Web/Vazio 1,0
Aplicativo Web ASP.NET Core (Modelo-Exibição-Controlador) mvc [C#], F# Web/MVC 1,0
Aplicativo Web ASP.NET Core webapp, razor [C#] Web/MVC/Razor Pages 2.2, 2.0
Biblioteca de Classes do Razor razorclasslib [C#] Web/Razor/Biblioteca/Biblioteca de Classes do Razor 2.1
API Web do ASP.NET Core webapi [C#], F# Web/Web API/API/Service/WebAPI 1.0
API do ASP.NET Core webapiaot [C#] Web/Web API/API/Service 8.0
Controlador de API do ASP.NET Core apicontroller [C#] Web/ASP.NET 8.0
Serviço gRPC do ASP.NET Core grpc [C#] Web/gRPC 3,0
Arquivo dotnet gitignore gitignore Config 3,0
Arquivo global.json globaljson Config 2,0
Configuração do NuGet nugetconfig Config 1,0
Arquivo de manifesto da ferramenta local do dotnet tool-manifest Config 3,0
Configuração da Web webconfig Config 1,0
Arquivo de Solução sln Solução 1,0
Arquivo de buffer de protocolo proto Web/gRPC 3,0
Arquivo EditorConfig editorconfig Config 6,0

A tabela a seguir mostra modelos que foram descontinuados e não vêm mais pré-instalados com o SDK do .NET. Clique no link de nome curto para ver as opções de modelo específicas.

Modelos Nome curto Idioma Marcações Descontinuado desde
ASP.NET Core com Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core com React.js react [C#] Web/MVC/SPA 8.0
Aplicativo para servidores Blazor blazorserver [C#] Web/Blazor 8.0
Blazor Aplicativo de servidor vazio blazorserver-empty [C#] Web/Blazor 8.0
BlazorWebAssembly Aplicativo vazio blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Opções de modelo

Cada modelo pode ter opções adicionais disponíveis. Para mostrar as opções adicionais disponíveis para o modelo, use a opção --help com o argumento de nome do modelo, por exemplo: dotnet new console --help. Caso o modelo dê suporte a vários idiomas, esse comando mostrará ajuda para o modelo no idioma padrão. Ao combiná-lo com a opção --language, você pode ver a ajuda para outros idiomas: dotnet new console --help --language F#. Os modelos fornecidos com o SDK do .NET têm as seguintes opções adicionais:

console

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Disponível desde o SDK do .NET Core 3.0.

    A seguinte tabela lista os valores padrão de acordo com a versão do SDK que você está usando:

    Versão do SDK Valor padrão
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    3.1 netcoreapp3.1

    A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 7 instalado, o único valor disponível para --framework será net7.0. Se você instalar o SDK do .NET 6, o valor net6.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

    Como alternativa, para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, instale o pacote NuGet do modelo. Os tipos de projeto Comuns, Web e SPA usam pacotes diferentes de acordo com o TFM (Moniker da Estrutura de Destino). Por exemplo, para criar um projeto console direcionado ao netcoreapp1.0, execute dotnet new install em Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3. Sem suporte para F#. Disponível desde o SDK do .NET Core 2.2.

    Para obter uma lista de versões C# padrão, confira Padrões.

  • --no-restore

    Se especificado, não executa uma restauração implícita durante a criação do projeto. Disponível desde o SDK do .NET Core 2.2.

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false. Disponível somente para C#.

classlib

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Valores: net8.0, net7.0ou net6.0 para criar uma Biblioteca de Classes .NET ou netstandard2.0netstandard2.1 para criar uma Biblioteca de Classes do .NET Standard. O valor padrão para o SDK do .NET 8.0.x é net8.0.

    Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --langVersion <VERSION_NUMBER>

    Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3. Sem suporte para F#. Disponível desde o SDK do .NET Core 2.2.

    Para obter uma lista de versões C# padrão, confira Padrões.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

wpf, wpflib, wpfcustomcontrollib, wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Para o SDK do .NET 8, o valor padrão é net8.0. Disponível desde o SDK do .NET Core 3.1.

  • --langVersion <VERSION_NUMBER>

    Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3.

    Para obter uma lista de versões C# padrão, confira Padrões.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3.

    Para obter uma lista de versões C# padrão, confira Padrões.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. O valor padrão para o SDK do .NET 8 é net8.0. Disponível desde o SDK do .NET Core 3.1.

    Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

mstest, xunit

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Opção disponível desde o SDK do .NET Core 3.0.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 6 instalado, o único valor disponível para --framework será net6.0. Se você instalar o SDK do .NET 5, o valor net5.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

  • -p|--enable-pack

    Habilita o empacotamento para o projeto usando dotnet pack.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

nunit

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 6 instalado, o único valor disponível para --framework será net6.0. Se você instalar o SDK do .NET 5, o valor net5.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

  • -p|--enable-pack

    Habilita o empacotamento para o projeto usando dotnet pack.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

page

  • -na|--namespace <NAMESPACE_NAME>

    Namespace do código gerado. O valor padrão é MyApp.Namespace.

  • -np|--no-pagemodel

    Cria a página sem um PageModel.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Namespace do código gerado. O valor padrão é MyApp.Namespace.

blazorserver

Descontinuado desde o SDK do .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

    O tipo de autenticação a ser usado. Os valores possíveis são:

    • None – Nenhuma autenticação (Padrão).
    • Individual – Autenticação individual.
    • IndividualB2C – Autenticação individual com o Azure AD B2C.
    • SingleOrg – Autenticação organizacional para um único locatário. Os locatários de ID externa do Entra também usam SingleOrg.
    • MultiOrg – Autenticação organizacional para vários locatários.
    • Windows – Autenticação do Windows.

  • --aad-b2c-instance <INSTANCE>

    A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://login.microsoftonline.com/tfp/.

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

    A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

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

    A ID da política de redefinição de senha desse projeto. Use com a autenticação do IndividualB2C.

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

    A ID da política de perfil de edição desse projeto. Use com a autenticação do IndividualB2C.

  • --aad-instance <INSTANCE>

    A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação SingleOrg ou MultiOrg. O valor padrão é https://login.microsoftonline.com/.

  • --client-id <ID>

    A ID do cliente desse projeto. Use com a autenticação IndividualB2C, SingleOrg ou MultiOrg. O valor padrão é 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    O domínio do locatário do diretório. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é qualified.domain.name.

  • --tenant-id <ID>

    A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    O caminho da solicitação no caminho base do aplicativo do URI de redirecionamento. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é /signin-oidc.

  • -r|--org-read-access

    Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg ou MultiOrg.

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • --no-https

    Desativa o HTTPS. Essa opção é aplicável somente quando Individual, IndividualB2C, SingleOrg ou MultiOrg não estão sendo usados para --auth.

  • -uld|--use-local-db

    Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --kestrelHttpPort

    Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

  • --kestrelHttpsPort

    Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

blazor

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino.

    Esse modelo está disponível para .NET 8 ou posterior.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --exclude-launch-settings

    Exclui launchSettings.json do aplicativo gerado.

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

    Especifica o modo de renderização interativo a ser usado para componentes interativos. Os valores possíveis são:

    • None - Sem interatividade (somente renderização estática do lado do servidor).
    • Server - (Padrão) Executa o aplicativo no servidor com renderização interativa no lado do servidor.
    • WebAssembly - Executa o aplicativo usando a renderização no lado do cliente no navegador com WebAssembly.
    • Auto - Usa a renderização interativa do lado do servidor enquanto baixa o pacote Blazor e ativa o runtime Blazor no cliente e, em seguida, usa a renderização do lado do cliente com WebAssembly.

  • --empty

    Omite exemplos de páginas e estilos que demonstram padrões básicos de uso.

  • -au|--auth <AUTHENTICATION_TYPE>

    O tipo de autenticação a ser usado. Os valores possíveis são:

    • None – Nenhuma autenticação (Padrão).
    • Individual – Autenticação individual.

  • -uld|--use-local-db

    Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual.

  • -ai|--all-interactive

    Torna todas as páginas interativas ao aplicar um modo de renderização interativo no nível superior. Se false, as páginas usarão renderização estática do lado do servidor por padrão e poderão ser marcadas como interativas por página ou por componente. Essa opção só será válida se a opção -i|--interactivity não estiver definida como None.

  • --no-https

    Desativa o HTTPS. Essa opção só se aplica se Individual não for escolhido para a opção -au|--auth.

  • --use-program-main

    Se especificado, uma classe Program e um método Main explícitos serão gerados em vez de instruções de nível superior.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5,0 net5.0
    3.1 netcoreapp3.1

    Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • -ho|--hosted

    Inclui um host do ASP.NET Core para o aplicativo BlazorWebAssembly.

  • -au|--auth <AUTHENTICATION_TYPE>

    O tipo de autenticação a ser usado. Os valores possíveis são:

    • None – Nenhuma autenticação (Padrão).
    • Individual – Autenticação individual.
    • IndividualB2C – Autenticação individual com o Azure AD B2C.
    • SingleOrg – Autenticação organizacional para um único locatário. Os locatários do Entra External ID também usam o SingleOrg.

  • --authority <AUTHORITY>

    A autoridade do provedor OIDC. Use com a autenticação do Individual. O valor padrão é https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://aadB2CInstance.b2clogin.com/.

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

    A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

  • --aad-instance <INSTANCE>

    A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é https://login.microsoftonline.com/.

  • --client-id <ID>

    A ID do cliente desse projeto. Use com a autenticação IndividualB2C, SingleOrg ou Individual em cenários autônomos. O valor padrão é 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    O domínio do locatário do diretório. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é qualified.domain.name.

  • --app-id-uri <URI>

    O URI da ID do aplicativo da API do servidor que você quer chamar. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é api.id.uri.

  • --api-client-id <ID>

    A ID do cliente da API que o servidor hospeda. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é 11111111-1111-1111-11111111111111111.

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

    O escopo da API que o cliente precisa solicitar para provisionar um token de acesso. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é user_impersonation.

  • --tenant-id <ID>

    A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg.

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • -p|--pwa

    produz um PWA (Aplicativo Web Progressivo) que dá suporte à instalação e ao uso offline.

  • --no-https

    Desativa o HTTPS. Essa opção é aplicável somente quando Individual, IndividualB2C ou SingleOrg não estão sendo usados para --auth.

  • -uld|--use-local-db

    Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C.

  • --called-api-url <URL>

    URL da API a ser chamada por meio do aplicativo Web. Aplica-se somente à autenticação SingleOrg ou IndividualB2C sem um host do ASP.NET Core especificado. O valor padrão é https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Especifica se o aplicativo Web chama o Microsoft Graph. Aplicável apenas à autenticação SingleOrg.

  • --called-api-scopes <SCOPES>

    Os escopos a serem solicitados para chamar a API por meio do aplicativo Web. Aplica-se somente à autenticação SingleOrg ou IndividualB2C sem um host do ASP.NET Core especificado. O padrão é user.read.

  • --kestrelHttpPort

    Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

  • --kestrelHttpsPort

    Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

web

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Opção não disponível no SDK do .NET Core 2.2.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    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 criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --no-https

    Desativa o HTTPS.

  • --kestrelHttpPort

    Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

  • --kestrelHttpsPort

    Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    O tipo de autenticação a ser usado. Os valores possíveis são:

    • None – Nenhuma autenticação (Padrão).
    • Individual – Autenticação individual.
    • IndividualB2C – Autenticação individual com o Azure AD B2C.
    • SingleOrg – Autenticação organizacional para um único locatário. Os locatários do Entra External ID também usam o SingleOrg.
    • MultiOrg – Autenticação organizacional para vários locatários.
    • Windows – Autenticação do Windows.

  • --aad-b2c-instance <INSTANCE>

    A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://login.microsoftonline.com/tfp/.

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

    A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

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

    A ID da política de redefinição de senha desse projeto. Use com a autenticação do IndividualB2C.

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

    A ID da política de perfil de edição desse projeto. Use com a autenticação do IndividualB2C.

  • --aad-instance <INSTANCE>

    A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação SingleOrg ou MultiOrg. O valor padrão é https://login.microsoftonline.com/.

  • --client-id <ID>

    A ID do cliente desse projeto. Use com a autenticação IndividualB2C, SingleOrg ou MultiOrg. O valor padrão é 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    O domínio do locatário do diretório. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é qualified.domain.name.

  • --tenant-id <ID>

    A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    O caminho da solicitação no caminho base do aplicativo do URI de redirecionamento. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é /signin-oidc.

  • -r|--org-read-access

    Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg ou MultiOrg.

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • --no-https

    Desativa o HTTPS. Essa opção é aplicável somente se Individual, IndividualB2C, SingleOrg ou MultiOrg não estão sendo usados.

  • -uld|--use-local-db

    Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Opção disponível desde o SDK do .NET Core 3.0.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    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 criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --use-browserlink

    Inclui BrowserLink no projeto. Opção não disponível no SDK do .NET Core 2.2 e 3.1.

  • -rrc|--razor-runtime-compilation

    Determina se o projeto está configurado para usar a compilação de runtime do Razor em builds de depuração. Opção disponível desde o SDK do .NET Core 3.1.201.

  • --kestrelHttpPort

    Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

  • --kestrelHttpsPort

    Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

angular, react

Descontinuado desde o SDK do .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

    O tipo de autenticação a ser usado. Disponível desde o SDK do .NET Core 3.0.

    Os valores possíveis são:

    • None – Nenhuma autenticação (Padrão).
    • Individual – Autenticação individual.

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --no-https

    Desativa o HTTPS. Essa opção só se aplicará se a autenticação for None.

  • -uld|--use-local-db

    Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C. Disponível desde o SDK do .NET Core 3.0.

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Opção não disponível no SDK do .NET Core 2.2.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Observação

    Não há um modelo do React para net8.0, entretanto, se você estiver interessado em desenvolver aplicativos React com ASP.NET Core, consulte Visão geral dos Aplicativos de Página Única (SPAs) no ASP.NET Core.

    Versão do SDK Valor padrão
    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 criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --kestrelHttpPort

    Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

  • --kestrelHttpsPort

    Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

razorclasslib

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

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

    Dá suporte à adição de páginas e exibições tradicionais do Razor, além dos componentes dessa biblioteca. Disponível desde o SDK do .NET Core 3.0.

webapiaot

Cria um projeto de API Web com a publicação AOT habilitada. Para obter mais informações, confira Implantação AOT nativa e Modelo de API Web (AOT nativo).

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    8.0 net8.0

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    O tipo de autenticação a ser usado. Os valores possíveis são:

    • None – Nenhuma autenticação (Padrão).
    • IndividualB2C – Autenticação individual com o Azure AD B2C.
    • SingleOrg – Autenticação organizacional para um único locatário. Os locatários do Entra External ID também usam o SingleOrg.
    • Windows – Autenticação do Windows.

  • --aad-b2c-instance <INSTANCE>

    A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Crie um projeto que use a API mínima ASP.NET Core. O padrão é false, mas essa opção é substituída por -controllers. Como o padrão para -controllers é false, inserir dotnet new webapi sem especificar nenhuma das opções cria um projeto de API mínima.

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

    A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

  • --aad-instance <INSTANCE>

    A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é https://login.microsoftonline.com/.

  • --client-id <ID>

    A ID do cliente desse projeto. Use com a autenticação IndividualB2C ou SingleOrg. O valor padrão é 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Utilizar ou não controladores em vez de APIs mínimas. Se tanto essa opção quanto -minimal forem especificadas, essa opção substituirá o valor especificado por -minimal. O padrão é false. Disponível desde o SDK do .NET 8.

  • --domain <DOMAIN>

    O domínio do locatário do diretório. Use com a autenticação IndividualB2C ou SingleOrg. O valor padrão é qualified.domain.name.

  • --tenant-id <ID>

    A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg.

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • --no-openapi

    Desativa o suporte a OpenAPI (Swagger). AddSwaggerGen, UseSwagger e UseSwaggerUI não são chamados.

  • --no-https

    Desativa o HTTPS. Nenhum perfil de inicialização https é criado em launchSettings.json. app.UseHsts e app.UseHttpsRedirection não são chamados em Program.cs/Startup.cs. Essa opção só se aplica quando IndividualB2C ou SingleOrg não está sendo usado para autenticação.

  • -uld|--use-local-db

    Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura de destino. Opção não disponível no SDK do .NET Core 2.2.

    A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

    Versão do SDK Valor padrão
    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 criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

  • --no-restore

    Não executa uma restauração implícita durante a criação do projeto.

  • --use-program-main

    Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

apicontroller

Controlador de API com ou sem ações de leitura/gravação.

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

    O namespace para o código gerado. O padrão é MyApp.Namespace.

  • -ac|--actions

    Crie um controlador com ações de leitura/gravação. O padrão é false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    Especifica a versão do SDK do .NET a ser usada no arquivo global.json.

editorconfig

Cria um arquivo .editorconfig para configurar preferências de estilo de código.

  • --empty

    Cria um .editorconfig vazio em vez dos padrões para .NET.

Confira também