Condividi tramite

Modelli predefiniti .NET per dotnet new

  • Articolo

Quando si installa .NET SDK, si ricevono più di una dozzina di modelli predefiniti per la creazione di progetti e file, tra cui app console, librerie di classi, progetti di unit test, app ASP.NET Core (inclusi Angular e progetti React) e file di configurazione. Per elencare i modelli predefiniti, eseguire il comando dotnet new list:

dotnet new list

La tabella seguente illustra i modelli preinstallati con .NET SDK. Il linguaggio predefinito per il modello è indicato tra parentesi quadre. Fare clic sul collegamento nome breve per visualizzare le opzioni del modello specifiche.

Modelli Nome breve Lingua Tag Presentazione
Applicazione console console [C#], F#, VB Comune/Console 1.0
Libreria di classi classlib [C#], F#, VB Comune/Library 1.0
Applicazione WPF wpf [C#], VB Common/WPF 3.0 (5.0 per VB)
Libreria di classi WPF wpflib [C#], VB Common/WPF 3.0 (5.0 per VB)
Libreria di controlli personalizzati WPF wpfcustomcontrollib [C#], VB Common/WPF 3.0 (5.0 per VB)
Libreria di controlli utente WPF wpfusercontrollib [C#], VB Common/WPF 3.0 (5.0 per VB)
Applicazione Windows Forms (WinForms) winforms [C#], VB Common/WinForms 3.0 (5.0 per VB)
Libreria di classi Windows Form (WinForms) winformslib [C#], VB Common/WinForms 3.0 (5.0 per VB)
Servizio del ruolo di lavoro worker [C#] Common/Ruolo di lavoro/Web 3,0
Progetto di test MSTest mstest [C#], F#, VB Test/MSTest 1.0
Classe di test MSTest mstest-class [C#], F#, VB Test/MSTest 1.0
Progetto di test NUnit 3 nunit [C#], F#, VB Test/NUnit 2.1.400
Elemento di test NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2.2
Progetto di test xUnit xunit [C#], F#, VB Test/xUnit 1.0
Componente Razor razorcomponent [C#] Web/ASP.NET 3,0
Pagina 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
App Web Blazor blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly App autonoma blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
Progetto ASP.NET Core vuoto web [C#], F# Web/Vuoto 1.0
App Web ASP.NET Core (Model-View-Controller) mvc [C#], F# Web/MVC 1.0
App Web ASP.NET Core webapp, razor [C#] Web/MVC/Razor Pages 2.2, 2.0
Libreria di classi Razor razorclasslib [C#] Web/Razor/Libreria/Libreria di classi Razor 2.1
API Web ASP.NET Core webapi [C#], F# API Web/API/API/Servizio/WebAPI 1.0
ASP.NET Core API webapiaot [C#] Web/API Web/API/Servizio 8.0
controller API core ASP.NET apicontroller [C#] Web/ASP.NET 8.0
Servizio gRPC ASP.NET Core grpc [C#] Web/gRPC 3,0
file dotnet gitignore gitignore Config 3,0
File global.json globaljson Config 2.0
Configurazione NuGet nugetconfig Config 1.0
File manifesto di strumento locale dotnet tool-manifest Config 3,0
Configurazione Web webconfig Config 1.0
File di soluzione sln Soluzione 1.0
File buffer del protocollo proto Web/gRPC 3,0
File EditorConfig editorconfig Config 6.0

La tabella seguente illustra i modelli che sono stati sospesi e non sono più preinstallati con .NET SDK. Fare clic sul collegamento nome breve per visualizzare le opzioni del modello specifiche.

Modelli Nome breve Lingua Tag Non più disponibile a partire da
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
App server Blazor blazorserver [C#] Web/Blazor 8.0
App serverBlazor vuota blazorserver-empty [C#] Web/Blazor 8.0
BlazorWebAssembly App vuota blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Opzioni modello

Ogni modello può avere opzioni aggiuntive disponibili. Per visualizzare le opzioni aggiuntive disponibili per il modello, usare l'opzione --help con l'argomento nome modello, ad esempio: dotnet new console --help. Nel caso in cui il modello supporti più lingue, questo comando mostrerà la Guida per il modello nella lingua predefinita. Combinandolo con l'opzione --language, è possibile visualizzare la Guida per altre lingue: dotnet new console --help --language F#. I modelli forniti con .NET SDK hanno le opzioni aggiuntive seguenti:

console

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Disponibile a partire da .NET Core 3.0 SDK.

    La tabella seguente elenca i valori predefiniti in base alla versione dell'SDK in uso:

    Versione dell'SDK Valore predefinito
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    3.1 netcoreapp3.1

    La possibilità di creare un progetto per un TFM precedente dipende dalla disponibilità di tale versione dell'SDK installata. Ad esempio, se è installato solo .NET 7 SDK, l'unico valore disponibile per --framework è net7.0. Se si installa .NET 6 SDK, il valore net6.0 diventa disponibile per --framework. Se si installa .NET Core 3.1 SDK, netcoreapp3.1 diventa disponibile e così via. Specificando --framework netcoreapp3.1 quindi è possibile usare .NET Core 3.1 anche durante l'esecuzione di dotnet new in .NET 6 SDK.

    In alternativa, per creare un progetto destinato a un framework precedente all'SDK in uso, potrebbe essere possibile installarlo installando il pacchetto NuGet per il modello. I tipi di progetto Common, Webe SPA utilizzano pacchetti diversi per ogni moniker del framework di destinazione (TFM). Ad esempio, per creare un progetto di console destinato a netcoreapp1.0, eseguire dotnet new install in Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Imposta la proprietà LangVersion nel file di progetto creato. Ad esempio, usare --langVersion 7.3 per usare C# 7.3. Non supportata per F#. Disponibile a partire da .NET Core 2.2 SDK.

    Per un elenco delle versioni C# predefinite, vedere Defaults (Impostazioni predefinite).

  • --no-restore

    Se specificato, non esegue un ripristino implicito durante la creazione del progetto. Disponibile a partire da .NET Core 2.2 SDK.

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false Disponibile solo per C#.

classlib

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Valori: net8.0, net7.0o net6.0 per creare una libreria di classi .NET o netstandard2.1 netstandard2.0 per creare una libreria di classi .NET Standard. Il valore predefinito per .NET SDK 8.0.x è net8.0.

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --langVersion <VERSION_NUMBER>

    Imposta la proprietà LangVersion nel file di progetto creato. Ad esempio, usare --langVersion 7.3 per usare C# 7.3. Non supportata per F#. Disponibile a partire da .NET Core 2.2 SDK.

    Per un elenco delle versioni C# predefinite, vedere Defaults (Impostazioni predefinite).

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

wpf, wpflib, wpfcustomcontrollibwpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Per .NET 8 SDK, il valore predefinito è net8.0. Disponibile a partire da .NET Core 3.1 SDK.

  • --langVersion <VERSION_NUMBER>

    Imposta la proprietà LangVersion nel file di progetto creato. Ad esempio, usare --langVersion 7.3 per usare C# 7.3.

    Per un elenco delle versioni C# predefinite, vedere Defaults (Impostazioni predefinite).

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Imposta la proprietà LangVersion nel file di progetto creato. Ad esempio, usare --langVersion 7.3 per usare C# 7.3.

    Per un elenco delle versioni C# predefinite, vedere Defaults (Impostazioni predefinite).

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Il valore predefinito per .NET 8 SDK è net8.0. Disponibile a partire da .NET Core 3.1 SDK.

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

mstest

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Opzione disponibile a partire da .NET Core 3.0 SDK.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Default value
    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 possibilità di creare un progetto per un TFM precedente dipende dalla disponibilità di tale versione dell'SDK installata. Ad esempio, se è installato solo .NET 6 SDK, l'unico valore disponibile per --framework è net6.0. Se si installa .NET 5 SDK, il valore net5.0 diventa disponibile per --framework. Se si installa .NET Core 3.1 SDK, netcoreapp3.1 diventa disponibile e così via. Specificando --framework netcoreapp3.1 quindi è possibile usare .NET Core 3.1 anche durante l'esecuzione di dotnet new in .NET 6 SDK.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --sdk

    Usare lo stile del progetto MSTest.Sdk.

  • --test-runner <TEST_RUNNER>

    Strumento di esecuzione/piattaforma per il progetto di test. I valori possibili sono:

    • VSTest - Piattaforma VSTest (impostazione predefinita).
    • MSTest - MSTest Runner (ad esempio Microsoft.Testing.Platform).

  • --coverage-tool <COVERAGE_TOOL>

    Strumento di copertura da usare per il progetto di test. I valori possibili sono:

    • Microsoft.CodeCoverage - Microsoft Code Coverage (impostazione predefinita).
    • coverlet - strumento di copertura copertura.

  • --extensions-profile <EXTENSIONS_PROFILE>

    Profilo delle estensioni SDK quando si usa MSTest Runner. I valori possibili sono:

    • Default - Profilo delle estensioni predefinito (impostazione predefinita).
    • None - Non viene abilitata alcuna estensione.
    • AllMicrosoft - Abilita tutte le estensioni fornite da Microsoft (incluse le estensioni con una licenza restrittiva).

  • --fixture <FIXTURE>

    Tipi di fixture da includere nel progetto di test. I valori possibili sono:

    • None - Nessun metodo di fixture.
    • AssemblyInitialize - AssemblyInitialize metodo fixture.
    • AssemblyCleanup - Metodo della fixture AssemblyCleanup.
    • ClassInitialize - ClassInitialize metodo fixture.
    • ClassCleanup - Metodo di fixture ClassCleanup.
    • TestInitialize - Metodo di fixture TestInitialize.
    • TestCleanup - Metodo di fixture TestCleanup.

    Dove sono consentiti più valori.

  • -p|--enable-pack

    Abilita la creazione di pacchetti per il progetto usando dotnet pack.

mstest-class

  • --fixture <FIXTURE>

    Tipi di fixture da includere nel progetto di test. I valori possibili sono:

    • None - Nessun metodo di fixture.
    • AssemblyInitialize - AssemblyInitialize metodo fixture.
    • AssemblyCleanup - Metodo della fixture AssemblyCleanup.
    • ClassInitialize - ClassInitialize metodo fixture.
    • ClassCleanup - Metodo di fixture ClassCleanup.
    • TestInitialize - Metodo di fixture TestInitialize.
    • TestCleanup - Metodo di fixture TestCleanup.

    Dove sono consentiti più valori.

xunit

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Opzione disponibile a partire da .NET Core 3.0 SDK.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Default value
    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 possibilità di creare un progetto per un TFM precedente dipende dalla disponibilità di tale versione dell'SDK installata. Ad esempio, se è installato solo .NET 6 SDK, l'unico valore disponibile per --framework è net6.0. Se si installa .NET 5 SDK, il valore net5.0 diventa disponibile per --framework. Se si installa .NET Core 3.1 SDK, netcoreapp3.1 diventa disponibile e così via. Specificando --framework netcoreapp3.1 quindi è possibile usare .NET Core 3.1 anche durante l'esecuzione di dotnet new in .NET 6 SDK.

  • -p|--enable-pack

    Abilita la creazione di pacchetti per il progetto usando dotnet pack.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

nunit

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Default value
    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 possibilità di creare un progetto per un TFM precedente dipende dalla disponibilità di tale versione dell'SDK installata. Ad esempio, se è installato solo .NET 6 SDK, l'unico valore disponibile per --framework è net6.0. Se si installa .NET 5 SDK, il valore net5.0 diventa disponibile per --framework. Se si installa .NET Core 3.1 SDK, netcoreapp3.1 diventa disponibile e così via. Specificando --framework netcoreapp3.1 quindi è possibile usare .NET Core 3.1 anche durante l'esecuzione di dotnet new in .NET 6 SDK.

  • -p|--enable-pack

    Abilita la creazione di pacchetti per il progetto usando dotnet pack.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

page

  • -na|--namespace <NAMESPACE_NAME>

    Spazio dei nomi per il codice generato. Il valore predefinito è MyApp.Namespace.

  • -np|--no-pagemodel

    Crea la pagina senza pageModel.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Spazio dei nomi per il codice generato. Il valore predefinito è MyApp.Namespace.

blazorserver

Non più disponibile a partire da .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo di autenticazione da usare. I valori possibili sono:

    • None: nessuna autenticazione (valore predefinito).
    • Individual: autenticazione singola.
    • IndividualB2C: singola autenticazione con Azure AD B2C.
    • SingleOrg: autenticazione aziendale per un singolo tenant. Anche i tenant di Entra External ID usano SingleOrg.
    • MultiOrg: autenticazione aziendale per più tenant.
    • Windows: autenticazione di Windows.

  • --aad-b2c-instance <INSTANCE>

    Istanza di Azure Active Directory B2C a cui connettersi. Usare con l'autenticazione IndividualB2C. Il valore predefinito è https://login.microsoftonline.com/tfp/.

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

    ID dei criteri di accesso e iscrizione per questo progetto. Usare con l'autenticazione IndividualB2C.

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

    ID criterio password di reimpostazione per questo progetto. Usare con l'autenticazione IndividualB2C.

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

    ID criterio del profilo di modifica per questo progetto. Usare con l'autenticazione IndividualB2C.

  • --aad-instance <INSTANCE>

    Istanza di Azure Active Directory a cui connettersi. Usare con l'autenticazione SingleOrg o MultiOrg. Il valore predefinito è https://login.microsoftonline.com/.

  • --client-id <ID>

    ID client per questo progetto. Usare con l'autenticazione IndividualB2C, SingleOrg o MultiOrg. Il valore predefinito è 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio per il tenant della directory. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è qualified.domain.name.

  • --tenant-id <ID>

    ID TenantId della directory a cui connettersi. Usare con l'autenticazione SingleOrg. Il valore predefinito è 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Percorso della richiesta all'interno del percorso di base dell'applicazione dell'URI di reindirizzamento. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è /signin-oidc.

  • -r|--org-read-access

    Consente all'applicazione l'accesso in lettura alla directory. Si applica solo all'autenticazione SingleOrg o MultiOrg.

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • --no-https

    Disattiva HTTPS. Questa opzione si applica solo se Individual, IndividualB2C, SingleOrg o MultiOrg non vengono usati per --auth.

  • -uld|--use-local-db

    Specifica che il database locale deve essere usato invece di SQLite. Si applica solo all'autenticazione Individual o IndividualB2C.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --kestrelHttpPort

    Numero di porta da usare per l'endpoint HTTP in launchSettings.json.

  • --kestrelHttpsPort

    Numero di porta da usare per l'endpoint HTTPS in launchSettings.json. Questa opzione non è applicabile quando viene usato il parametro no-https ( ma no-https viene ignorato quando viene scelta un'impostazione di autenticazione individuale o organizzativa per --auth).

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

blazor

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione.

    Questo modello è disponibile per .NET 8 o versione successiva.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --exclude-launch-settings

    Esclude launchSettings.json dall'app generata.

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

    Specifica la modalità di rendering interattiva da usare per i componenti interattivi. I valori possibili sono:

    • None - Nessuna interattività (solo rendering lato server statico).
    • Server - (Impostazione predefinita) Esegue l'app sul server con rendering sul lato server interattivo.
    • WebAssembly - Esegue l'app usando il rendering lato client nel browser con WebAssembly.
    • Auto - Usa il rendering lato server interattivo durante il download del bundle Blazor e l'attivazione del runtime Blazor nel client, quindi usa il rendering lato client con WebAssembly.

  • --empty

    Omette pagine di esempio e stili che illustrano modelli di utilizzo di base.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo di autenticazione da usare. I valori possibili sono:

    • None: nessuna autenticazione (valore predefinito).
    • Individual: autenticazione singola.

  • -uld|--use-local-db

    Specifica che il database locale deve essere usato invece di SQLite. Si applica solo all'autenticazione Individual.

  • -ai|--all-interactive

    Rende interattiva ogni pagina applicando una modalità di rendering interattiva al livello superiore. Se false, le pagine usano il rendering statico lato server per impostazione predefinita e possono essere contrassegnate come interattive per pagina o per componente. Questa opzione è valida solo se l'opzione -i|--interactivity non è impostata su None.

  • --no-https

    Disattiva HTTPS. Questa opzione si applica solo se Individual non viene scelta per l'opzione -au|--auth.

  • --use-program-main

    Se specificato, viene generata una classe Program esplicita e un metodo Main anziché istruzioni di primo livello.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Valore predefinito
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • -ho|--hosted

    Include un host ASP.NET Core per l'app BlazorWebAssembly.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo di autenticazione da usare. I valori possibili sono:

    • None: nessuna autenticazione (valore predefinito).
    • Individual: autenticazione singola.
    • IndividualB2C: singola autenticazione con Azure AD B2C.
    • SingleOrg: autenticazione aziendale per un singolo tenant. I tenant Entra External ID usano anche SingleOrg.

  • --authority <AUTHORITY>

    Autorità del provider OIDC. Usare con l'autenticazione Individual. Il valore predefinito è https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    Istanza di Azure Active Directory B2C a cui connettersi. Usare con l'autenticazione IndividualB2C. Il valore predefinito è https://aadB2CInstance.b2clogin.com/.

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

    ID dei criteri di accesso e iscrizione per questo progetto. Usare con l'autenticazione IndividualB2C.

  • --aad-instance <INSTANCE>

    Istanza di Azure Active Directory a cui connettersi. Usare con l'autenticazione SingleOrg. Il valore predefinito è https://login.microsoftonline.com/.

  • --client-id <ID>

    ID client per questo progetto. Usare con l'autenticazione IndividualB2C, SingleOrg o Individual in scenari autonomi. Il valore predefinito è 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Dominio per il tenant della directory. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è qualified.domain.name.

  • --app-id-uri <URI>

    Uri ID app per l'API server che si vuole chiamare. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è api.id.uri.

  • --api-client-id <ID>

    ID client per l'API ospitata dal server. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è 11111111-1111-1111-11111111111111111.

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

    L'ambito dell'API che il client deve richiedere per effettuare il provisioning di un token di accesso. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è user_impersonation.

  • --tenant-id <ID>

    ID TenantId della directory a cui connettersi. Usare con l'autenticazione SingleOrg. Il valore predefinito è 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Consente all'applicazione l'accesso in lettura alla directory. Si applica solo all'autenticazione SingleOrg.

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • -p|--pwa

    produce un'applicazione Web progressiva (PWA) che supporta l'installazione e l'uso offline.

  • --no-https

    Disattiva HTTPS. Questa opzione si applica solo se Individual, IndividualB2C, SingleOrg o --auth non sono in uso.

  • -uld|--use-local-db

    Specifica che il database locale deve essere usato invece di SQLite. Si applica solo all'autenticazione Individual o IndividualB2C.

  • --called-api-url <URL>

    URL dell'API da chiamare dall'app Web. Si applica solo all'autenticazione SingleOrg o IndividualB2C senza un host core ASP.NET specificato. Il valore predefinito è https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Specifica se l'app Web chiama Microsoft Graph. Si applica solo all'autenticazione SingleOrg.

  • --called-api-scopes <SCOPES>

    Ambiti da richiedere per chiamare l'API dall'app Web. Si applica solo all'autenticazione SingleOrg o IndividualB2C senza un host core ASP.NET specificato. Il valore predefinito è user.read.

  • --kestrelHttpPort

    Numero di porta da usare per l'endpoint HTTP in launchSettings.json.

  • --kestrelHttpsPort

    Numero di porta da usare per l'endpoint HTTPS in launchSettings.json. Questa opzione non è applicabile quando viene usato il parametro no-https ( ma no-https viene ignorato quando viene scelta un'impostazione di autenticazione individuale o organizzativa per --auth).

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

web

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Opzione non disponibile in .NET Core 2.2 SDK.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Valore predefinito
    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

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --no-https

    Disattiva HTTPS.

  • --kestrelHttpPort

    Numero di porta da usare per l'endpoint HTTP in launchSettings.json.

  • --kestrelHttpsPort

    Numero di porta da usare per l'endpoint HTTPS in launchSettings.json. Questa opzione non è applicabile quando viene usato il parametro no-https ( ma no-https viene ignorato quando viene scelta un'impostazione di autenticazione individuale o organizzativa per --auth).

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo di autenticazione da usare. I valori possibili sono:

    • None: nessuna autenticazione (valore predefinito).
    • Individual: autenticazione singola.
    • IndividualB2C: singola autenticazione con Azure AD B2C.
    • SingleOrg: autenticazione aziendale per un singolo tenant. I tenant Entra External ID usano anche SingleOrg.
    • MultiOrg: autenticazione aziendale per più tenant.
    • Windows: autenticazione di Windows.

  • --aad-b2c-instance <INSTANCE>

    Istanza di Azure Active Directory B2C a cui connettersi. Usare con l'autenticazione IndividualB2C. Il valore predefinito è https://login.microsoftonline.com/tfp/.

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

    ID dei criteri di accesso e iscrizione per questo progetto. Usare con l'autenticazione IndividualB2C.

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

    ID criterio password di reimpostazione per questo progetto. Usare con l'autenticazione IndividualB2C.

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

    ID criterio del profilo di modifica per questo progetto. Usare con l'autenticazione IndividualB2C.

  • --aad-instance <INSTANCE>

    Istanza di Azure Active Directory a cui connettersi. Usare con l'autenticazione SingleOrg o MultiOrg. Il valore predefinito è https://login.microsoftonline.com/.

  • --client-id <ID>

    ID client per questo progetto. Usare con l'autenticazione IndividualB2C, SingleOrg o MultiOrg. Il valore predefinito è 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio per il tenant della directory. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è qualified.domain.name.

  • --tenant-id <ID>

    ID TenantId della directory a cui connettersi. Usare con l'autenticazione SingleOrg. Il valore predefinito è 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Percorso della richiesta all'interno del percorso di base dell'applicazione dell'URI di reindirizzamento. Usare con l'autenticazione SingleOrg o IndividualB2C. Il valore predefinito è /signin-oidc.

  • -r|--org-read-access

    Consente all'applicazione l'accesso in lettura alla directory. Si applica solo all'autenticazione SingleOrg o MultiOrg.

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • --no-https

    Disattiva HTTPS. Questa opzione si applica solo se Individual, IndividualB2C, SingleOrg o MultiOrg non sono in uso.

  • -uld|--use-local-db

    Specifica che il database locale deve essere usato invece di SQLite. Si applica solo all'autenticazione Individual o IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Opzione disponibile a partire da .NET Core 3.0 SDK.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Valore predefinito
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --use-browserlink

    Include BrowserLink nel progetto. Opzione non disponibile in .NET Core 2.2 e 3.1 SDK.

  • -rrc|--razor-runtime-compilation

    Determina se il progetto è configurato per l'uso compilazione del runtime Razor nelle compilazioni di debug. Opzione disponibile a partire da .NET Core 3.1.201 SDK.

  • --kestrelHttpPort

    Numero di porta da usare per l'endpoint HTTP in launchSettings.json.

  • --kestrelHttpsPort

    Numero di porta da usare per l'endpoint HTTPS in launchSettings.json. Questa opzione non è applicabile quando viene usato il parametro no-https ( ma no-https viene ignorato quando viene scelta un'impostazione di autenticazione individuale o organizzativa per --auth).

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

angular, react

Non più disponibile a partire da .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo di autenticazione da usare. Disponibile a partire da .NET Core 3.0 SDK.

    I valori possibili sono:

    • None: nessuna autenticazione (valore predefinito).
    • Individual: autenticazione singola.

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --no-https

    Disattiva HTTPS. Questa opzione si applica solo se l'autenticazione è None.

  • -uld|--use-local-db

    Specifica che il database locale deve essere usato invece di SQLite. Si applica solo all'autenticazione Individual o IndividualB2C. Disponibile a partire da .NET Core 3.0 SDK.

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Opzione non disponibile in .NET Core 2.2 SDK.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Nota

    Non esiste un modello React per net8.0, tuttavia, se si è interessati allo sviluppo di app React con ASP.NET Core, vedere Panoramica delle app a pagina singola in ASP.NET Core.

    Versione dell'SDK Valore predefinito
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3,0 netcoreapp3.0
    2.1 netcoreapp2.0

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --kestrelHttpPort

    Numero di porta da usare per l'endpoint HTTP in launchSettings.json.

  • --kestrelHttpsPort

    Numero di porta da usare per l'endpoint HTTPS in launchSettings.json. Questa opzione non è applicabile quando viene usato il parametro no-https ( ma no-https viene ignorato quando viene scelta un'impostazione di autenticazione individuale o organizzativa per --auth).

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

razorclasslib

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

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

    Supporta l'aggiunta di visualizzazioni e pagine Razor tradizionali oltre ai componenti di questa libreria. Disponibile a partire da .NET Core 3.0 SDK.

webapiaot

Crea un progetto API Web con pubblicazione AOT abilitata. Per altre informazioni, vedere Distribuzione AOT nativa e Modello api Web (AOT nativo).

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Valore predefinito
    8.0 net8.0

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo di autenticazione da usare. I valori possibili sono:

    • None: nessuna autenticazione (valore predefinito).
    • IndividualB2C: singola autenticazione con Azure AD B2C.
    • SingleOrg: autenticazione aziendale per un singolo tenant. I tenant Entra External ID usano anche SingleOrg.
    • Windows: autenticazione di Windows.

  • --aad-b2c-instance <INSTANCE>

    Istanza di Azure Active Directory B2C a cui connettersi. Usare con l'autenticazione IndividualB2C. Il valore predefinito è https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Creare un progetto che usa l' API minima ASP.NET core. Il valore predefinito è false, ma questa opzione viene sostituita da -controllers. Poiché l'impostazione predefinita per -controllers è false, l'immissione di dotnet new webapi senza specificare alcuna opzione crea un progetto API minimo.

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

    ID dei criteri di accesso e iscrizione per questo progetto. Usare con l'autenticazione IndividualB2C.

  • --aad-instance <INSTANCE>

    Istanza di Azure Active Directory a cui connettersi. Usare con l'autenticazione SingleOrg. Il valore predefinito è https://login.microsoftonline.com/.

  • --client-id <ID>

    ID client per questo progetto. Usare con l'autenticazione IndividualB2C o SingleOrg. Il valore predefinito è 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Indica se usare i controller invece delle API minime. Se sono specificate sia questa opzione che -minimal, questa opzione sostituisce il valore specificato da -minimal. Il valore predefinito è false. Disponibile a partire da .NET 8 SDK.

  • --domain <DOMAIN>

    Dominio per il tenant della directory. Usare con l'autenticazione IndividualB2C o SingleOrg. Il valore predefinito è qualified.domain.name.

  • --tenant-id <ID>

    ID TenantId della directory a cui connettersi. Usare con l'autenticazione SingleOrg. Il valore predefinito è 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Consente all'applicazione l'accesso in lettura alla directory. Si applica solo all'autenticazione SingleOrg.

  • --exclude-launch-settings

    Esclude launchSettings.json dal modello generato.

  • --no-openapi

    Disattiva il supporto di OpenAPI (Swagger). AddSwaggerGen, UseSwagger e UseSwaggerUI non vengono chiamati.

  • --no-https

    Disattiva HTTPS. Non viene creato alcun profilo di avvio https in launchSettings.json. app.UseHsts e app.UseHttpsRedirection non vengono chiamati in Program.cs/Startup.cs. Questa opzione si applica solo se IndividualB2C o SingleOrg non vengono usati per l'autenticazione.

  • -uld|--use-local-db

    Specifica che il database locale deve essere usato invece di SQLite. Si applica solo all'autenticazione IndividualB2C.

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione. Opzione non disponibile in .NET Core 2.2 SDK.

    La tabella seguente elenca i valori predefiniti in base al numero di versione dell'SDK in uso:

    Versione dell'SDK Valore predefinito
    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

    Per creare un progetto destinato a un framework precedente all'SDK in uso, vedere --framework per i progetti console in precedenza in questo articolo.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --use-program-main

    Se specificato, verrà usata una classe Program esplicito e un metodo Main anziché istruzioni di primo livello. Disponibile a partire da .NET SDK 6.0.300. Valore predefinito: false

apicontroller

Controller API con o senza azioni di lettura/scrittura.

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

    Spazio dei nomi per il codice generato. Il valore predefinito è MyApp.Namespace.

  • -ac|--actions

    Creare un controller con azioni di lettura/scrittura. Il valore predefinito è false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    Specifica la versione di .NET SDK da usare nel file global.json.

  • --roll-forward <ROLL_FORWARD_POLICY>

    I criteri di roll forward da usare quando si seleziona una versione dell'SDK, sia come fallback quando manca una versione specifica dell'SDK sia come direttiva per usare una versione successiva. Per altre informazioni, vedere global-json.

editorconfig

Crea un file .editorconfig per la configurazione delle preferenze di stile del codice.

  • --empty

    Crea un file con estensione editorconfig vuoto anziché le impostazioni predefinite per .NET.

Vedi anche