Condividi tramite

Modelli predefiniti per dotnet new

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

Opzioni modello

I modelli forniti con .NET SDK hanno opzioni specifiche del modello. Per visualizzare le opzioni aggiuntive disponibili per il modello, usare l'opzione --help con l'argomento nome modello, ad esempio : dotnet new console --help. Le sezioni specifiche del modello in questo articolo descrivono anche le opzioni.

Se il modello supporta più linguaggi di programmazione, l'opzione --help mostrerà la Guida per il modello nel linguaggio predefinito. Combinandolo con l'opzione --language, è possibile visualizzare la Guida per altre lingue: dotnet new console --help --language F#.

Modelli preinstallati

La tabella seguente illustra i modelli preinstallati con .NET SDK. La lingua predefinita per il modello viene visualizzata tra parentesi quadre. Per visualizzare le opzioni specifiche del modello, selezionare il collegamento nome breve.

Modelli Nome breve Lingua Tag Presentazione
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
Progetto ASP.NET Core vuoto web [C#], F# Web/Vuoto 1.0
API Web ASP.NET Core webapi [C#], F# API Web/API/API/Servizio/WebAPI 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#] Pagine Web/MVC/Razor 2.2, 2.0
Servizio gRPC ASP.NET Core grpc [C#] Web/gRPC 3,0
App Web Blazor blazor [C#] Ragnatela/Blazor 8.0.100
Blazor WebAssembly App autonoma blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
Libreria di classi classlib [C#], F#, VB Comune/Library 1.0
Applicazione console console [C#], F#, VB Comune/Console 1.0
File Directory.Build.props buildprops Config 8.0.100
File Directory.Build.targets buildtargets Config 8.0.100
File manifesto di strumento locale dotnet tool-manifest Config 3,0
File EditorConfig editorconfig Config 6.0
File con estensione gitignore gitignore Config 3,0
File global.json globaljson Config 2.0
Classe di test MSTest mstest-class [C#], F#, VB Test/MSTest 1.0
Progetto di test MSTest mstest [C#], F#, VB Test/MSTest 1.0
Elemento di test NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2.2
Progetto di test NUnit 3 nunit [C#], F#, VB Test/NUnit 2.1.400
Configurazione NuGet nugetconfig Config 1.0
File buffer del protocollo proto Web/gRPC 3,0
Libreria di classi Razor razorclasslib [C#] Web/Razor/Libreria/Libreria di classi Razor 2.1
Componente Razor razorcomponent [C#] Web/ASP.NET 3,0
Pagina Razor page [C#] Web/ASP.NET 2.0
File di soluzione sln Soluzione 1.0
Configurazione Web webconfig Config 1.0
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
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)
Progetto di test xUnit xunit [C#], F#, VB Test/xUnit 1.0
Visualizzazione MVCImports viewimports [C#] Web/ASP.NET 2.0
Visualizzazione MVCStart viewstart [C#] Web/ASP.NET 2.0

buildprops

Crea un file Directory.Build.props per personalizzare le proprietà di MSBuild per un intero albero delle cartelle. Per altre informazioni, vedere Personalizzare la compilazione.

  • --inherit

    Se specificato, aggiunge un elemento Import per il file Directory.Build.props più vicino nella gerarchia di directory padre. Per impostazione predefinita, i file Directory.Build.props non ereditano dalle directory padre, quindi l'abilitazione di questa opzione consente di creare una gerarchia di personalizzazioni cartella per cartella.

  • --use-artifacts

    Se specificato, aggiunge una proprietà per abilitare il layout di output degli artefatti. Si tratta di un modello comune per i progetti che producono artefatti di compilazione, ad esempio pacchetti NuGet, inseriti in una struttura di cartelle comune. Per altre informazioni, vedere Layout di output degli artefatti.

buildtargets

Crea un file Directory.Build.targets per personalizzare le destinazioni e le attività di MSBuild per un intero albero delle cartelle. Per altre informazioni, vedere Personalizzare la compilazione.

  • --inherit

    Se specificato, aggiunge un elemento Import per il file Directory.Build.targets più vicino nella gerarchia di directory padre. Per impostazione predefinita, i file Directory.Build.targets non ereditano dalle directory padre, quindi l'abilitazione di questa opzione consente di creare una gerarchia di personalizzazioni cartella per cartella.

console

  • -f|--framework <FRAMEWORK>

    Specifica il framework di destinazione.

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

    Versione dell'SDK Valore predefinito
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0

    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 9 SDK, l'unico valore disponibile per --framework è net9.0. Se, ad esempio, si installa .NET 8 SDK, il valore net8.0 diventa disponibile per --framework. Specificando quindi --framework net8.0 è possibile usare .NET 8 anche durante l'esecuzione di dotnet new in .NET 9 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#.

    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.

  • --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: net9.0, net8.0o net7.0 per creare una libreria di classi .NET o netstandard2.1netstandard2.0 per creare una libreria di classi .NET Standard. Il valore predefinito per .NET SDK 9.0.x è net9.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#.

    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 9 SDK, il valore predefinito è net9.0.

  • --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 9 SDK è net9.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.

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

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

    Versione dell'SDK Valore predefinito
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

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 9 SDK, l'unico valore disponibile per --framework è net9.0. Se ad esempio si installa .NET 8 SDK, il valore net8.0 diventa disponibile per --framework. Specificando quindi --framework net8.0 è possibile usare .NET 8 anche durante l'esecuzione di dotnet new in .NET 9 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 - 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 Microsoft.Testing.Platform. 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.

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

    Versione dell'SDK Valore predefinito
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

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 9 SDK, l'unico valore disponibile per --framework è net9.0. Se ad esempio si installa .NET 8 SDK, il valore net8.0 diventa disponibile per --framework. Specificando quindi --framework net8.0 è possibile usare .NET 8 anche durante l'esecuzione di dotnet new in .NET 9 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 Valore predefinito
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

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 9 SDK, l'unico valore disponibile per --framework è net9.0. Se ad esempio si installa .NET 8 SDK, il valore net8.0 diventa disponibile per --framework. Specificando quindi --framework net8.0 è possibile usare .NET 8 anche durante l'esecuzione di dotnet new in .NET 9 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.

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.

web

  • --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
    10.0 net10.0
    9.0 net9.0
    8.0 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.

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

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

    Versione dell'SDK Valore predefinito
    10.0 net10.0
    9.0 net9.0
    8.0 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.

  • --no-restore

    Non esegue un ripristino implicito durante la creazione del progetto.

  • --use-browserlink

    Include BrowserLink nel progetto.

  • -rrc|--razor-runtime-compilation

    Determina se il progetto è configurato per l'uso compilazione del runtime Razor nelle compilazioni di debug.

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

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
    10.0 net10.0
    9.0 net9.0
    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). AddOpenApi e MapOpenApi 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.

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

    Versione dell'SDK Valore predefinito
    10.0 net10.0
    9.0 net9.0
    8.0 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.

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

  • --test-runner <TEST_RUNNER>

    Questa opzione è stata introdotta in .NET 10 SDK e specifica il test runner da usare, VSTest o Microsoft.Testing.Platform. Il valore predefinito è VSTest.

sln

Crea un file di soluzione vuoto che non contiene progetti.

Nota

In .NET SDK 9.0.200 e versioni successive questo modello supporta un'opzione --format tra sln i formati e slnx . A partire da .NET 10, il formato predefinito è slnx.

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.

Modelli non più disponibili

La tabella seguente illustra i modelli che sono stati sospesi e non sono più preinstallati con .NET SDK. Per visualizzare le opzioni specifiche del modello, selezionare il collegamento nome breve.

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#] Ragnatela/Blazor 8.0
App serverBlazor vuota blazorserver-empty [C#] Ragnatela/Blazor 8.0
Blazor WebAssembly App vuota blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

angular, react

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.

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

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

    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

    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

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

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
    10.0 net10.0
    9.0 net9.0
    8.0 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.

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

Vedi anche

  • Last updated on