dotnet aspnet-codegenerator

Di Rick Anderson

dotnet aspnet-codegenerator - Esegue il motore di scaffolding di ASP.NET Core. dotnet aspnet-codegenerator è necessario solo per eseguire lo scaffolding dalla riga di comando. Non è necessario per usare lo scaffolding con Visual Studio.

Installare e aggiornare aspnet-codegenerator

Installare .NET SDK.

dotnet aspnet-codegenerator è uno strumento global che deve essere installato. Il comando seguente installa l'ultima versione stabile dello strumento dotnet aspnet-codegenerator:

dotnet tool install -g dotnet-aspnet-codegenerator

Nota

Per impostazione predefinita, l'architettura dei file binari .NET da installare rappresenta l'architettura del sistema operativo attualmente in esecuzione. Per specificare un'architettura del sistema operativo diversa, vedere l'opzione dotnet tool install, --arch. Per altre informazioni, vedere Problema di GitHub dotnet/AspNetCore.Docs #29262.

Il comando seguente aggiorna dotnet aspnet-codegenerator alla versione stabile più recente disponibile dai .NET Core SDK installati:

dotnet tool update -g dotnet-aspnet-codegenerator

Disinstallare aspnet-codegenerator

Potrebbe essere necessario disinstallare per aspnet-codegenerator risolvere i problemi. Ad esempio, se è stata installata una versione di anteprima di , disinstallarla prima di aspnet-codegeneratorinstallare la versione rilasciata.

I comandi seguenti disinstallano lo dotnet aspnet-codegenerator strumento e installano la versione stabile più recente:

dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Riepilogo

dotnet aspnet-codegenerator [arguments] [-p|--project] [-n|--nuget-package-dir] [-c|--configuration] [-tfm|--target-framework] [-b|--build-base-path] [--no-build] 
dotnet aspnet-codegenerator [-h|--help]

Descrizione

Il comando globale dotnet aspnet-codegenerator esegue il generatore di codice e il motore di scaffolding di ASP.NET Core.

Argomenti

generator

Il generatore di codice da eseguire. Sono disponibili i generatori seguenti:

Generatore Operazione
area Esegue lo scaffolding di un'area
controller Esegue lo scaffolding di un controller
autenticazione Ponteggi Identity
razorpage Scaffolding pagine Razor
view Esegue lo scaffolding di una visualizzazione

Opzioni

-n|--nuget-package-dir

Specifica la directory del pacchetto NuGet.

-c|--configuration {Debug|Release}

Definisce la configurazione di compilazione. Il valore predefinito è Debug.

-tfm|--target-framework

Framework di destinazione da usare. Ad esempio, net46.

-b|--build-base-path

Percorso di base di compilazione.

-h|--help

Stampa una breve guida per il comando.

--no-build

Non compila il progetto prima dell'esecuzione. Imposta anche in modo implicito il flag --no-restore.

-p|--project <PATH>

Specifica il percorso del file di progetto da eseguire: nome della cartella o percorso completo. Se non specificato, per impostazione predefinita il percorso corrisponde alla directory corrente.

Opzioni del generatore

Nelle sezioni seguenti vengono descritte in dettaglio le opzioni disponibili per i generatori supportati:

  • Area
  • Controller
  • Identity
  • Razorpage
  • Visualizzazione

Opzioni per area

Questo strumento è progettato per i progetti Web ASP.NET Core con controller e visualizzazioni. Non è destinato alle Razor app Pages.

Sintassi: dotnet aspnet-codegenerator area AreaNameToGenerate

Il comando precedente genera le cartelle seguenti:

  • Aree
    • AreaNameToGenerate
      • Controller
      • Dati
      • Modelli
      • Visualizzazioni

Opzioni per controller

Nella tabella seguente sono elencate le opzioni per aspnet-codegeneratorrazorpagee controllerview:

Opzione Descrizione
--model oppure -m Classe di modelli da usare.
--dataContext oppure -dc Classe DbContext da utilizzare o il nome della classe da generare.
--bootstrapVersion oppure -b Specifica la versione di bootstrap. I valori validi sono 3 o 4. Il valore predefinito è 4. Se necessaria e non presente, viene creata una directory wwwroot che include i file di bootstrap della versione specificata.
--referenceScriptLibraries oppure -scripts Librerie di script di riferimento nelle viste generate. Aggiunge _ValidationScriptsPartial per modificare e creare pagine.
--layout oppure -l Pagina di layout personalizzata da usare.
--useDefaultLayout oppure -udl Usare il layout predefinito per le viste.
--force oppure -f Sovrascrivere i file esistenti.
--relativeFolderPath oppure -outDir Specificare il percorso della cartella di output relativa dal progetto in cui deve essere generato il file, se non specificato, il file verrà generato nella cartella del progetto
--useSqlite o -sqlite Flag per specificare se DbContext deve usare SQLite anziché SQL Server.

La tabella seguente contiene un elenco di opzioni specifiche per aspnet-codegenerator controller:

Opzione Descrizione
--controllerName o -name Nome del controller.
--useAsyncActions o -async Genera le azioni del controller asincrone.
--noViews or -nv Non genera alcuna visualizzazione.
--restWithNoViews o -api Generare un controller con REST l'API di stile. Si presuppone noViews e qualsiasi opzione correlata alla visualizzazione viene ignorata.
--readWriteActions o -actions Genera un controller con azioni di lettura/scrittura senza un modello.

Usare l'opzione -h per ottenere informazioni della Guida per il comando aspnet-codegenerator controller:

dotnet aspnet-codegenerator controller -h

Vedere Eseguire lo scaffolding del modello di filmato per un esempio di dotnet aspnet-codegenerator controller.

Razorpage

Razor Le pagine possono essere scaffolding singolarmente specificando il nome della nuova pagina e il modello da usare. I modelli supportati sono:

  • Empty
  • Create
  • Edit
  • Delete
  • Details
  • List

Ad esempio, il comando seguente usa il modello Modifica per generare MyEdit.cshtml e MyEdit.cshtml.cs:

dotnet aspnet-codegenerator razorpage MyEdit Edit -m Movie -dc RazorPagesMovieContext -outDir Pages/Movies

In genere, il modello e il nome di file generato non vengono specificati e vengono creati i modelli seguenti:

  • Create
  • Edit
  • Delete
  • Details
  • List

Nella tabella seguente sono elencate le opzioni per aspnet-codegeneratorrazorpagee controllerview:

Opzione Descrizione
--model oppure -m Classe di modelli da usare.
--dataContext oppure -dc Classe DbContext da utilizzare o il nome della classe da generare.
--bootstrapVersion oppure -b Specifica la versione di bootstrap. I valori validi sono 3 o 4. Il valore predefinito è 4. Se necessaria e non presente, viene creata una directory wwwroot che include i file di bootstrap della versione specificata.
--referenceScriptLibraries oppure -scripts Librerie di script di riferimento nelle viste generate. Aggiunge _ValidationScriptsPartial per modificare e creare pagine.
--layout oppure -l Pagina di layout personalizzata da usare.
--useDefaultLayout oppure -udl Usare il layout predefinito per le viste.
--force oppure -f Sovrascrivere i file esistenti.
--relativeFolderPath oppure -outDir Specificare il percorso della cartella di output relativa dal progetto in cui deve essere generato il file, se non specificato, il file verrà generato nella cartella del progetto
--useSqlite o -sqlite Flag per specificare se DbContext deve usare SQLite anziché SQL Server.

La tabella seguente contiene un elenco di opzioni specifiche per aspnet-codegenerator razorpage:

Opzione Descrizione
--namespaceName o -namespace Nome dello spazio dei nomi da usare per il PageModel generato
--partialView o -partial Genera una visualizzazione parziale. Le opzioni di layout -l e -udl vengono ignorate se viene specificata questa opzione.
--noPageModel o -npm Opzione per non generare una classe PageModel per un modello vuoto

Usare l'opzione -h per ottenere informazioni della Guida per il comando aspnet-codegenerator razorpage:

dotnet aspnet-codegenerator razorpage -h

Vedere Eseguire lo scaffolding del modello di filmato per un esempio di dotnet aspnet-codegenerator razorpage.

Visualizzazione

Le viste possono essere scaffolding singolarmente specificando il nome della visualizzazione e il modello da usare. I modelli supportati sono:

  • Empty
  • Create
  • Edit
  • Delete
  • Details
  • List

Ad esempio, il comando seguente usa il modello Modifica per generare MyEdit.cshtml:

dotnet aspnet-codegenerator view MyEdit Edit -m Movie -dc MovieContext -outDir Views/Movies

Nella tabella seguente sono elencate le opzioni per aspnet-codegeneratorrazorpagee controllerview:

Opzione Descrizione
--model oppure -m Classe di modelli da usare.
--dataContext oppure -dc Classe DbContext da utilizzare o il nome della classe da generare.
--bootstrapVersion oppure -b Specifica la versione di bootstrap. I valori validi sono 3 o 4. Il valore predefinito è 4. Se necessaria e non presente, viene creata una directory wwwroot che include i file di bootstrap della versione specificata.
--referenceScriptLibraries oppure -scripts Librerie di script di riferimento nelle viste generate. Aggiunge _ValidationScriptsPartial per modificare e creare pagine.
--layout oppure -l Pagina di layout personalizzata da usare.
--useDefaultLayout oppure -udl Usare il layout predefinito per le viste.
--force oppure -f Sovrascrivere i file esistenti.
--relativeFolderPath oppure -outDir Specificare il percorso della cartella di output relativa dal progetto in cui deve essere generato il file, se non specificato, il file verrà generato nella cartella del progetto
--useSqlite o -sqlite Flag per specificare se DbContext deve usare SQLite anziché SQL Server.

La tabella seguente contiene un elenco di opzioni specifiche per aspnet-codegenerator view:

Opzione Descrizione
--controllerNamespace o -namespace Specificare il nome dello spazio dei nomi da usare per il controller generato
--partialView o -partial Generare una visualizzazione parziale, altre opzioni di layout (-l e -udl) vengono ignorate se viene specificato

Usare l'opzione -h per ottenere informazioni della Guida per il comando aspnet-codegenerator view:

dotnet aspnet-codegenerator view -h

Identity

Vedere Scaffolding Identity