Parte 2, aggiungere un modello a un'app Razor Pages in ASP.NET Core

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto> RazorPagesMovie Aggiungi>nuova cartella. Denominare la cartella Models.

2. Fare clic con il pulsante destro del mouse sulla Models cartella. Selezionare Aggiungi>Classe. Denominare la classe Movie.

3. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• Attributo [DataType] che specifica il tipo di dati nella ReleaseDate proprietà . Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

• Il punto interrogativo dopo string indica che la proprietà è nullable. Per altre informazioni, vedere Tipi di riferimento Nullable.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Compilare il progetto per verificare che non siano presenti errori di compilazione.

1. Aggiungere una cartella denominata Models.
2. Aggiungere una classe alla Models cartella denominata Movie.cs.

Aggiungere le proprietà seguenti alla classe Movie:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

• Il punto interrogativo dopo string indica che la proprietà è nullable. Per altre informazioni, vedere Tipi di riferimento Nullable.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Aggiungere i pacchetti NuGet e gli strumenti EF

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design --prerelease
dotnet add package Microsoft.EntityFrameworkCore.SQLite --prerelease
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --prerelease
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --prerelease
dotnet add package Microsoft.EntityFrameworkCore.Tools --prerelease

I comandi precedenti aggiungono:

• Strumenti dell'interfaccia della riga di comando per EF Core
• Strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Provider EF Core SQLite, che installa il EF Core pacchetto come dipendenza.
• I pacchetti necessari per lo scaffolding: Microsoft.VisualStudio.Web.CodeGeneration.Design e Microsoft.EntityFrameworkCore.SqlServer.

Per indicazioni sulla configurazione di più ambienti che consente a un'app di configurare i contesti di database in base all'ambiente, vedere Usare più ambienti in ASP.NET Core.

In Visual Studio Code premere CTRL+F5 (Windows) o ⌘+F5 (macOS) per eseguire l'app senza eseguire il debug.

Nel pannello sotto l'area dell'editor selezionare la scheda PROBLEMI o dal menu Visualizza selezionare Problemi se non è attualmente visualizzata. Verificare che non siano presenti errori di compilazione.

1. Creare la cartella Pages/Movies :

   1. Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

2. Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo elemento con scaffolding.

   

3. Nella finestra di dialogo Aggiungi nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Aggiungi.

   

4. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nel menu a discesa Classe modello selezionare Movie (RazorPagesMovie.Models).
   2. Nella riga Classe contesto di dati selezionare il segno più +.
      1. Nella finestra di dialogo Aggiungi contesto dati viene generato il nome RazorPagesMovie.Data.RazorPagesMovieContext della classe.
      2. Nell'elenco a discesa Provider di database selezionare SQL Server.
   3. Selezionare Aggiungi.

   

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

• Aprire una shell dei comandi nella directory del progetto, che contiene i Program.cs file e .csproj . Esegui questo comando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni del generatore di codice core ASP.NET.

Usare l'opzione -h per ottenere informazioni sul dotnet aspnet-codegenerator razorpage comando:

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

In questa sezione viene usata la finestra Gestione pacchetti Console (PMC) per:

• Aggiungere una migrazione iniziale.

• Aggiornare il database con la migrazione iniziale.

• Nel menu Strumenti selezionare Gestione pacchetti NuGet>Console di Gestione pacchetti.

  

• In PMC immettere il comando seguente:

  Add-Migration InitialCreate
  

• Il comando Add-Migration genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare la migrazione. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

Viene visualizzato l'avviso seguente, risolto in un passaggio successivo:

No type was specified for the decimal column 'Price' on entity type 'Movie'. (Nessun tipo specificato per la colonna decimale 'Price' nel tipo di entità 'Movie'). This will cause values to be silently truncated if they do not fit in the default precision and scale. (I valori saranno quindi automaticamente troncati se non rispettano la precisione e la scala predefinite). Explicitly specify the SQL server column type that can accommodate all the values using 'HasColumnType()'. (Specificare in modo esplicito il tipo di colonna di SQL Server che può supportare tutti i valori usando 'HasColumnType()').

• In PMC immettere il comando seguente:

  Update-Database
  

  Il Update-Database comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, il comando esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

• Fare clic con il pulsante destro del mouse sul progetto RazorPagesMovie.csproj e quindi scegliere Apri nel terminale integrato.

  Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

• Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

  dotnet ef migrations add InitialCreate
  

  Il comando migrations genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare le migrazioni. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

• Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

  dotnet ef database update
  

  Il update comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, update esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto> RazorPagesMovie Aggiungi>nuova cartella. Denominare la cartella Models.

2. Fare clic con il pulsante destro del mouse sulla Models cartella. Selezionare Aggiungi>Classe. Denominare la classe Movie.

3. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• Attributo [DataType] che specifica il tipo di dati nella ReleaseDate proprietà . Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

• Il punto interrogativo dopo string indica che la proprietà è nullable. Per altre informazioni, vedere Tipi di riferimento Nullable.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Compilare il progetto per verificare che non siano presenti errori di compilazione.

1. Aggiungere una cartella denominata Models.
2. Aggiungere una classe alla Models cartella denominata Movie.cs.

Aggiungere le proprietà seguenti alla classe Movie:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

• Il punto interrogativo dopo string indica che la proprietà è nullable. Per altre informazioni, vedere Tipi di riferimento Nullable.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Aggiungere i pacchetti NuGet e gli strumenti EF

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

I comandi precedenti aggiungono:

• Strumenti dell'interfaccia della riga di comando per EF Core
• Strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Provider EF Core SQLite, che installa il EF Core pacchetto come dipendenza.
• I pacchetti necessari per lo scaffolding: Microsoft.VisualStudio.Web.CodeGeneration.Design e Microsoft.EntityFrameworkCore.SqlServer.

Per indicazioni sulla configurazione di più ambienti che consente a un'app di configurare i contesti di database in base all'ambiente, vedere Usare più ambienti in ASP.NET Core.

In Visual Studio Code premere CTRL+F5 (Windows) o ⌘+F5 (macOS) per eseguire l'app senza eseguire il debug.

Nel pannello sotto l'area dell'editor selezionare la scheda PROBLEMI o dal menu Visualizza selezionare Problemi se non è attualmente visualizzata. Verificare che non siano presenti errori di compilazione.

1. Nella finestra degli strumenti della soluzione fare clic sul progetto RazorPagesMovie e quindi selezionare Aggiungi>nuova cartella.... Assegnare alla cartella Modelsil nome .

2. Fare clic sulla Models cartella e quindi selezionare Aggiungi>nuova classe.

3. Nella finestra di dialogo Nuovo file:

   1. Selezionare Generale nel riquadro a sinistra.
   2. Selezionare Classe vuota nel riquadro centrale.
   3. Assegnare alla classe il nome Movie e selezionare Crea.

4. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Compilare il progetto per verificare che non siano presenti errori di compilazione.

1. Creare la cartella Pages/Movies :

   1. Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

2. Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo elemento con scaffolding.

   

3. Nella finestra di dialogo Aggiungi nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Aggiungi.

   

4. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nel menu a discesa Classe modello selezionare Movie (RazorPagesMovie.Models).
   2. Nella riga Classe contesto di dati selezionare il segno più +.
      1. Nella finestra di dialogo Aggiungi contesto dati viene generato il nome RazorPagesMovie.Data.RazorPagesMovieContext della classe.
      2. Nell'elenco a discesa Provider di database selezionare SQL Server.
   3. Selezionare Aggiungi.

   

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

• Aprire una shell dei comandi nella directory del progetto, che contiene i Program.cs file e .csproj . Esegui questo comando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni del generatore di codice core ASP.NET.

Usare l'opzione -h per ottenere informazioni sul dotnet aspnet-codegenerator razorpage comando:

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

1. Aggiungere il pacchetto Microsoft.EntityFrameworkCore.SqliteNuGet , necessario per lo strumento di scaffolding.

   1. Nella finestra degli strumenti della soluzione fare clic sul progetto RazorPagesMovie e quindi selezionare Apri nel terminale.

   Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

   1. Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Creare una cartella Pages/Movies:

   1. Fare clic sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

3. Fare clic con il pulsante di controllo sulla cartella >Pages/Movies Aggiungi>nuovo scaffolding....

   

4. Nella finestra di dialogo Nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Avanti.

   

5. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nella classe Model da usare: riga immettere Movie.
   2. Nella classe DbContext da usare: row denominare la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Selezionare Fine.

   

Il processo di scaffolding potrebbe richiedere del tempo perché i pacchetti necessari vengono scaricati e aggiunti automaticamente al progetto.

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

In questa sezione viene usata la finestra Gestione pacchetti Console (PMC) per:

• Aggiungere una migrazione iniziale.

• Aggiornare il database con la migrazione iniziale.

• Nel menu Strumenti selezionare Gestione pacchetti NuGet>Console di Gestione pacchetti.

  

• In PMC immettere il comando seguente:

  Add-Migration InitialCreate
  

• Il comando Add-Migration genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare la migrazione. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

Viene visualizzato l'avviso seguente, risolto in un passaggio successivo:

No type was specified for the decimal column 'Price' on entity type 'Movie'. (Nessun tipo specificato per la colonna decimale 'Price' nel tipo di entità 'Movie'). This will cause values to be silently truncated if they do not fit in the default precision and scale. (I valori saranno quindi automaticamente troncati se non rispettano la precisione e la scala predefinite). Explicitly specify the SQL server column type that can accommodate all the values using 'HasColumnType()'. (Specificare in modo esplicito il tipo di colonna di SQL Server che può supportare tutti i valori usando 'HasColumnType()').

• In PMC immettere il comando seguente:

  Update-Database
  

  Il Update-Database comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, il comando esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

• Fare clic con il pulsante destro del mouse sul progetto RazorPagesMovie.csproj e quindi scegliere Apri nel terminale integrato.

  Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

• Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

  dotnet ef migrations add InitialCreate
  

  Il comando migrations genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare le migrazioni. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

• Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

  dotnet ef database update
  

Il update comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, update esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

• Fare clic sul progetto RazorPagesMovie e quindi selezionare Apri nel terminale.

  Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

• Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

  dotnet tool uninstall --global dotnet-ef
  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• I tool comandi installano gli strumenti di Entity Framework Core più recenti dopo la disinstallazione di qualsiasi versione precedente, se presente.

  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 dotnet tool install, --opzione arch.. Per altre informazioni, vedere Problema di GitHub dotnet/AspNetCore.Docs #29262.

• Il comando migrations genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare le migrazioni. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

• Il update comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, update esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

Viene visualizzato l'avviso seguente, risolto in un passaggio successivo:

No type was specified for the decimal column 'Price' on entity type 'Movie'. (Nessun tipo specificato per la colonna decimale 'Price' nel tipo di entità 'Movie'). This will cause values to be silently truncated if they do not fit in the default precision and scale. (I valori saranno quindi automaticamente troncati se non rispettano la precisione e la scala predefinite). Explicitly specify the SQL server column type that can accommodate all the values using 'HasColumnType()'. (Specificare in modo esplicito il tipo di colonna di SQL Server che può supportare tutti i valori usando 'HasColumnType()').

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto> RazorPagesMovie Aggiungi>nuova cartella. Denominare la cartella Models.

2. Fare clic con il pulsante destro del mouse sulla Models cartella. Selezionare Aggiungi>Classe. Denominare la classe Movie.

3. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• Attributo [DataType] che specifica il tipo di dati nella ReleaseDate proprietà . Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

• Il punto interrogativo dopo string indica che la proprietà è nullable. Per altre informazioni, vedere Tipi di riferimento Nullable.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Compilare il progetto per verificare che non siano presenti errori di compilazione.

1. Aggiungere una cartella denominata Models.
2. Aggiungere una classe alla Models cartella denominata Movie.cs.

Aggiungere le proprietà seguenti alla classe Movie:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

• Il punto interrogativo dopo string indica che la proprietà è nullable. Per altre informazioni, vedere Tipi di riferimento Nullable.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Aggiungere i pacchetti NuGet e gli strumenti EF

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

I comandi precedenti aggiungono:

• Strumenti dell'interfaccia della riga di comando per EF Core
• Strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Provider EF Core SQLite, che installa il EF Core pacchetto come dipendenza.
• I pacchetti necessari per lo scaffolding: Microsoft.VisualStudio.Web.CodeGeneration.Design e Microsoft.EntityFrameworkCore.SqlServer.

Per indicazioni sulla configurazione di più ambienti che consente a un'app di configurare i contesti di database in base all'ambiente, vedere Usare più ambienti in ASP.NET Core.

In Visual Studio Code premere CTRL+F5 (Windows) o ⌘+F5 (macOS) per eseguire l'app senza eseguire il debug.

Nel pannello sotto l'area dell'editor selezionare la scheda PROBLEMI o dal menu Visualizza selezionare Problemi se non è attualmente visualizzata. Verificare che non siano presenti errori di compilazione.

1. Nella finestra degli strumenti della soluzione fare clic sul progetto RazorPagesMovie e quindi selezionare Aggiungi>nuova cartella.... Assegnare alla cartella Modelsil nome .

2. Fare clic sulla Models cartella e quindi selezionare Aggiungi>nuova classe.

3. Nella finestra di dialogo Nuovo file:

   1. Selezionare Generale nel riquadro a sinistra.
   2. Selezionare Classe vuota nel riquadro centrale.
   3. Assegnare alla classe il nome Movie e selezionare Crea.

4. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Compilare il progetto per verificare che non siano presenti errori di compilazione.

1. Creare la cartella Pages/Movies :

   1. Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

2. Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo elemento con scaffolding.

   

3. Nella finestra di dialogo Aggiungi nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Aggiungi.

   

4. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nel menu a discesa Classe modello selezionare Movie (RazorPagesMovie.Models).
   2. Nella riga Classe contesto di dati selezionare il segno più +.
      1. Nella finestra di dialogo Aggiungi contesto dati viene generato il nome RazorPagesMovie.Data.RazorPagesMovieContext della classe.
      2. Nell'elenco a discesa Provider di database selezionare SQL Server.
   3. Selezionare Aggiungi.

   

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

• Aprire una shell dei comandi nella directory del progetto, che contiene i Program.cs file e .csproj . Esegui questo comando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni del generatore di codice core ASP.NET.

Usare l'opzione -h per ottenere informazioni sul dotnet aspnet-codegenerator razorpage comando:

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

1. Aggiungere il pacchetto Microsoft.EntityFrameworkCore.SqliteNuGet , necessario per lo strumento di scaffolding.

   1. Nella finestra degli strumenti della soluzione fare clic sul progetto RazorPagesMovie e quindi selezionare Apri nel terminale.

   Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

   1. Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Creare una cartella Pages/Movies:

   1. Fare clic sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

3. Fare clic con il pulsante di controllo sulla cartella >Pages/Movies Aggiungi>nuovo scaffolding....

   

4. Nella finestra di dialogo Nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Avanti.

   

5. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nella classe Model da usare: riga immettere Movie.
   2. Nella classe DbContext da usare: row denominare la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Selezionare Fine.

   

Il processo di scaffolding potrebbe richiedere del tempo perché i pacchetti necessari vengono scaricati e aggiunti automaticamente al progetto.

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

In questa sezione viene usata la finestra Gestione pacchetti Console (PMC) per:

• Aggiungere una migrazione iniziale.
• Aggiornare il database con la migrazione iniziale.

1. Nel menu Strumenti selezionare Gestione pacchetti NuGet>Console di Gestione pacchetti.

   

2. Nella Console di Gestione pacchetti immettere i comandi seguenti:

   Add-Migration InitialCreate
   Update-Database
   

• Il comando Add-Migration genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare la migrazione. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

• Il Update-Database comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, il comando esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

• Fare clic con il pulsante destro del mouse sul progetto RazorPagesMovie.csproj e quindi scegliere Apri nel terminale integrato.

  Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

• Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• Il comando migrations genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare le migrazioni. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

• Il update comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, update esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

• Fare clic sul progetto RazorPagesMovie e quindi selezionare Apri nel terminale.

  Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

• Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

  dotnet tool uninstall --global dotnet-ef
  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• I tool comandi installano gli strumenti di Entity Framework Core più recenti dopo la disinstallazione di qualsiasi versione precedente, se presente.

  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 dotnet tool install, --opzione arch.. Per altre informazioni, vedere Problema di GitHub dotnet/AspNetCore.Docs #29262.

• Il comando migrations genera un codice per creare lo schema del database iniziale. Lo schema si basa sul modello specificato in DbContext. L'argomento InitialCreate viene usato per denominare le migrazioni. È possibile usare qualsiasi nome, ma per convenzione viene selezionato un nome che descrive la migrazione.

• Il update comando esegue il Up metodo nelle migrazioni che non sono state applicate. In questo caso, update esegue il Up metodo nel Migrations/<time-stamp>_InitialCreate.cs file , che crea il database.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto> RazorPagesMovie Aggiungi>nuova cartella. Denominare la cartella Models.

2. Fare clic con il pulsante destro del mouse sulla Models cartella. Selezionare Aggiungi>Classe. Denominare la classe Movie.

3. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; } = string.Empty;
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; } = string.Empty;
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• Attributo [DataType] che specifica il tipo di dati nella ReleaseDate proprietà . Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

1. Aggiungere una cartella denominata Models.
2. Aggiungere una classe alla Models cartella denominata Movie.cs.

Aggiungere le proprietà seguenti alla classe Movie:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; } = string.Empty;

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; } = string.Empty;
        public decimal Price { get; set; }
    }
}

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

Aggiungere i pacchetti NuGet e gli strumenti EF

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer

I comandi precedenti aggiungono:

• Strumenti dell'interfaccia della riga di comando per EF Core
• Strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Provider EF Core SQLite, che installa il EF Core pacchetto come dipendenza.
• I pacchetti necessari per lo scaffolding: Microsoft.VisualStudio.Web.CodeGeneration.Design e Microsoft.EntityFrameworkCore.SqlServer.

Per indicazioni sulla configurazione di più ambienti che consente a un'app di configurare i contesti di database in base all'ambiente, vedere Usare più ambienti in ASP.NET Core.

1. Nella finestra degli strumenti della soluzione fare clic con il pulsante destro del mouse sul progetto RazorPagesMovie e quindi scegliere Aggiungi>nuova cartella.... Assegnare alla cartella Modelsil nome .

2. Fare clic con il pulsante destro del mouse sulla Models cartella e quindi scegliere Aggiungi>nuovo file.

3. Nella finestra di dialogo Nuovo file:

   1. Selezionare Generale nel riquadro a sinistra.
   2. Selezionare Classe vuota nel riquadro centrale.
   3. Assegnare alla classe il nome Movie e selezionare Crea.

4. Aggiungere le proprietà seguenti alla classe Movie:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; } = string.Empty;
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; } = string.Empty;
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contiene:

• Campo ID per fornire una chiave primaria per il database.

• Attributo [DataType] per specificare il tipo di dati nel ReleaseDate campo. Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

1. Aggiungere il pacchetto Microsoft.EntityFrameworkCore.DesignNuGet , necessario per lo strumento di scaffolding.

   1. Dal menu Strumenti selezionare NuGet Gestione pacchetti> Gestisci pacchetti NuGet per la soluzione
   2. Selezionare la scheda Sfoglia.
   3. Immettere Microsoft.EntityFrameworkCore.Design e selezionarlo dall'elenco.
   4. Selezionare Progetto e quindi Selezionare Installa
   5. Selezionare Accetto nella finestra di dialogo Accettazione della licenza.

2. Creare la cartella Pages/Movies :

   1. Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

3. Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo elemento con scaffolding.

   

4. Nella finestra di dialogo Aggiungi nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Aggiungi.

   

5. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nel menu a discesa Classe modello selezionare Movie (RazorPagesMovie.Models).
   2. Nella riga Classe contesto di dati selezionare il segno più +.
      1. Nella finestra di dialogo Aggiungi contesto dati viene generato il nome RazorPagesMovie.Data.RazorPagesMovieContext della classe.
   3. Selezionare Aggiungi.

   

   Se viene visualizzato un messaggio di errore che indica che è necessario installare il Microsoft.EntityFrameworkCore.SqlServer pacchetto, ripetere i passaggi che iniziano con Add New Scaffolded Item (Aggiungi>nuovo elemento con scaffolding).

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

• Aprire una shell dei comandi nella directory del progetto, che contiene i Program.cs file e .csproj . Esegui questo comando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries -sqlite
  

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni del generatore di codice core ASP.NET.

Usare l'opzione -h per ottenere informazioni sul dotnet aspnet-codegenerator razorpage comando:

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

1. Creare una cartella Pages/Movies:

   1. Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

2. Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo scaffolding....

   

3. Nella finestra di dialogo Nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Avanti.

   

4. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nella classe Model da usare: riga immettere Movie.
   2. Nella classe DbContext da usare: row denominare la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Selezionare Fine.

   

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come selezionare il stringa di connessione SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Il codice precedente non chiama UseDeveloperExceptionPage lo sviluppo perché WebApplication chiama UseDeveloperExceptionPage in modalità di sviluppo.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

In questa sezione viene usata la finestra Gestione pacchetti Console (PMC) per:

• Aggiungere una migrazione iniziale.
• Aggiornare il database con la migrazione iniziale.

1. Nel menu Strumenti selezionare Gestione pacchetti NuGet>Console di Gestione pacchetti.

   

2. Nella Console di Gestione pacchetti immettere i comandi seguenti:

   Add-Migration InitialCreate
   Update-Database
   
   

• Nella finestra degli strumenti della soluzione fare clic con il pulsante destro del mouse sul progetto RazorPagesMovie e quindi scegliere Apri nel terminale.

  Viene visualizzata la finestra Terminale con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e csproj.

• Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

  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 dotnet tool install, --opzione arch.. Per altre informazioni, vedere Problema di GitHub dotnet/AspNetCore.Docs #29262.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto> RazorPagesMovie Aggiungi>nuova cartella. Denominare la cartella Models.

2. Fare clic con il pulsante destro del mouse sulla Models cartella. Selezionare Aggiungi>Classe. Denominare la classe Movie.

3. Aggiungere le proprietà seguenti alla classe Movie:

   using System;
   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; }
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; }
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• [DataType(DataType.Date)]: l'attributo [DataType] specifica il tipo di dati (Date). Con questo attributo:

  • L'utente non deve immettere le informazioni sull'ora nel campo data.
  • Viene visualizzata solo la data, non le informazioni temporali.

1. Aggiungere una cartella denominata Models.
2. Aggiungere una classe alla Models cartella denominata Movie.cs.

Aggiungere le proprietà seguenti alla classe Movie:

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• [DataType(DataType.Date)]: l'attributo [DataType] specifica il tipo di dati (Date). Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

Aggiungere i pacchetti NuGet e gli strumenti EF

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet tool install --global dotnet-ef
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer

I comandi precedenti aggiungono:

• Strumenti dell'interfaccia della riga di comando per EF Core
• Strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Provider EF Core SQLite, che installa il EF Core pacchetto come dipendenza.
• I pacchetti necessari per lo scaffolding: Microsoft.VisualStudio.Web.CodeGeneration.Design e Microsoft.EntityFrameworkCore.SqlServer.

Per indicazioni sulla configurazione di più ambienti che consente a un'app di configurare i contesti di database in base all'ambiente, vedere Usare più ambienti in ASP.NET Core.

Se viene visualizzato un errore di scaffolding, verificare che target Framework Moniker (TFM) corrisponda alla versione del pacchetto NuGet nel file di progetto. Ad esempio, il file di progetto seguente usa la versione 5.0 per .NET e i pacchetti NuGet elencati:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="5.0.0-*" />
  </ItemGroup>

</Project>

1. Nella finestra degli strumenti della soluzione fare clic sul progetto RazorPagesMovie e quindi selezionare Aggiungi>nuova cartella.... Assegnare alla cartella Modelsil nome .

2. Fare clic sulla Models cartella e quindi selezionare Aggiungi>nuovo file.

3. Nella finestra di dialogo Nuovo file:

   1. Selezionare Generale nel riquadro a sinistra.
   2. Selezionare Classe vuota nel riquadro centrale.
   3. Denominare la classe Movie e selezionare Nuovo.

4. Aggiungere le proprietà seguenti alla classe Movie:

   using System;
   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models
   {
       public class Movie
       {
           public int ID { get; set; }
           public string Title { get; set; }
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; }
           public decimal Price { get; set; }
       }
   }
   

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• [DataType(DataType.Date)]: l'attributo [DataType] specifica il tipo di dati (Date). Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

1. Creare una cartella Pages/Movies:

   1. Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

2. Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo elemento con scaffolding.

   

3. Nella finestra di dialogo Aggiungi scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Aggiungi.

   

4. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nel menu a discesa Classe modello selezionare Movie (RazorPagesMovie.Models).
   2. Nella riga Classe contesto di dati selezionare il segno più +.
      1. Nella finestra di dialogo Aggiungi contesto dati viene generato il nome RazorPagesMovie.Data.RazorPagesMovieContext della classe.
   3. Selezionare Aggiungi.

   

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

• Aprire una shell dei comandi nella directory del progetto, che contiene i Program.csfile , Startup.cse .csproj . Esegui questo comando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries -sqlite
  

Nella tabella seguente vengono fornite informazioni dettagliate sulle opzioni del generatore di codice core ASP.NET.

Usare l'opzione -h per ottenere informazioni sul dotnet aspnet-codegenerator razorpage comando:

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come inserire in IWebHostEnvironment Startup. IWebHostEnvironment viene inserito in modo da ConfigureServices poter usare SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

1. Creare una cartella Pages/Movies:

   1. Fare clic sulla cartella Pages Aggiungi>nuova cartella.>
   2. Assegnare alla cartella il nome Movies.

2. Fare clic con il pulsante di controllo sulla cartella >Pages/Movies Aggiungi>nuovo scaffolding....

   

3. Nella finestra di dialogo Nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Avanti.

   

4. Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

   1. Nella classe DbContext da usare: row denominare la classe RazorPagesMovie.Data.RazorPagesMovieContext.
   2. Selezionare Fine.

   

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come inserire in IWebHostEnvironment Startup. IWebHostEnvironment viene inserito in modo da ConfigureServices poter usare SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

In questa sezione viene usata la finestra Gestione pacchetti Console (PMC) per:

• Aggiungere una migrazione iniziale.
• Aggiornare il database con la migrazione iniziale.

1. Nel menu Strumenti selezionare Gestione pacchetti NuGet>Console di Gestione pacchetti.

   

2. Nella Console di Gestione pacchetti immettere i comandi seguenti:

   Add-Migration InitialCreate
   Update-Database
   

• Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

Esaminare il contesto registrato con l'inserimento di dipendenze

ASP.NET Core viene compilato con l'inserimento di dipendenze. I servizi, ad esempio il contesto del database, vengono registrati con inserimento delle dipendenze durante l'avvio EF Core dell'applicazione. I componenti che richiedono questi servizi (ad esempio Razor Pages) vengono forniti tramite parametri del costruttore. Più avanti nell'esercitazione viene illustrato il codice del costruttore che ottiene un'istanza del contesto di database.

Lo strumento di scaffolding ha creato automaticamente un contesto di database e lo ha registrato con il contenitore di inserimento delle dipendenze.

Esaminare il metodo Startup.ConfigureServices. La riga evidenziata è stata aggiunta dallo scaffolder:

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

La RazorPagesMovieContext funzionalità delle EF Core coordinate, ad esempio Create, Read, Update e Delete, per il Movie modello. Il contesto dei dati (RazorPagesMovieContext) è derivato da Microsoft.EntityFrameworkCore.DbContext. Il contesto dei dati specifica le entità incluse nel modello di dati.

using Microsoft.EntityFrameworkCore;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (
            DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
    }
}

Il codice precedente crea una proprietà DbSet<Movie> per il set di entità. Nella terminologia di Entity Framework, un set di entità corrisponde in genere alla tabella di un database. Un'entità corrisponde a una riga nella tabella.

Il nome della stringa di connessione viene passato al contesto chiamando un metodo in un oggetto DbContextOptions. Per lo sviluppo locale, il sistema di configurazione legge il stringa di connessione dal appsettings.json file.

Esaminare il metodo Up.

Fare clic con il pulsante destro del mouse sul progetto >RazorPagesMovie Aggiungi>nuova cartella. Denominare la cartella Models.

Fare clic con il pulsante destro del mouse sulla Models cartella. Selezionare Aggiungi>Classe. Denominare la classe Movie.

Aggiungere le proprietà seguenti alla classe Movie:

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• [DataType(DataType.Date)]: l'attributo DataType specifica il tipo di dati (Date). Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

• Aggiungere una cartella denominata Models.
• Aggiungere una classe alla Models cartella denominata Movie.cs.

Aggiungere le proprietà seguenti alla classe Movie:

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• [DataType(DataType.Date)]: l'attributo DataType specifica il tipo di dati (Date). Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

L'attributo DataAnnotations viene analizzato in un'esercitazione successiva.

Aggiungere i pacchetti NuGet e gli strumenti EF

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet tool install --global dotnet-ef --version 3.1.9
dotnet tool install --global dotnet-aspnet-codegenerator --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 3.1.9
dotnet add package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore --version 3.1.9
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Design --version 3.1.9
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --version 3.1.9
dotnet add package Microsoft.Extensions.Logging.Debug --version 3.1.9

I comandi precedenti aggiungono:

• Strumento di scaffolding aspnet-codegenerator.
• Gli strumenti di Entity Framework Core per l'interfaccia della riga di comando di .NET.
• Provider EF Core SQLite, che installa il EF Core pacchetto come dipendenza.
• I pacchetti necessari per lo scaffolding: Microsoft.VisualStudio.Web.CodeGeneration.Design e Microsoft.EntityFrameworkCore.SqlServer.

Per indicazioni sulla configurazione di più ambienti che consente a un'app di configurare i contesti di database in base all'ambiente, vedere Usare più ambienti in ASP.NET Core.

Se viene visualizzato un errore di scaffolding, verificare che target Framework Moniker (TFM) corrisponda alla versione del pacchetto NuGet nel file di progetto. Ad esempio, il file di progetto seguente contiene la versione 3.1 per .NET Core e i pacchetti NuGet elencati:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="3.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="3.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.1.0" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="3.1.0" />
  </ItemGroup>

</Project>

Aggiungere una classe di contesto dei dati

• Nel progetto RazorPagesMovie creare una nuova cartella denominata Data.

• Aggiungere la classe RazorPagesMovieContext seguente alla cartella Data:

  using Microsoft.EntityFrameworkCore;
  
  namespace RazorPagesMovie.Data
  {
      public class RazorPagesMovieContext : DbContext
      {
          public RazorPagesMovieContext (
              DbContextOptions<RazorPagesMovieContext> options)
              : base(options)
          {
          }
  
          public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
      }
  }
  

il codice precedente crea una proprietà DbSet per il set di entità. Nella terminologia di Entity Framework, un set di entità corrisponde in genere alla tabella di un database e un'entità corrisponde a una riga della tabella. Il codice non verrà compilato finché le dipendenze non verranno aggiunte in un passaggio successivo.

Aggiungere una stringa di connessione del database

Aggiungere un stringa di connessione al appsettings.json file come illustrato nel codice evidenziato seguente:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Data Source=MvcMovie.db"
  }
}

Registrare il contesto del database

Aggiungere le istruzioni seguenti using all'inizio di Startup.cs:

using RazorPagesMovie.Data;
using Microsoft.EntityFrameworkCore;

Registrare il contesto del database con il contenitore di inserimento delle dipendenze in Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

• Nella finestra degli strumenti della soluzione fare clic sul progetto RazorPagesMovie e quindi selezionare Aggiungi>nuova cartella.... Assegnare alla cartella Modelsil nome .

• Fare clic con il pulsante destro del mouse sulla Models cartella e quindi scegliere Aggiungi>nuovo file.

• Nella finestra di dialogo Nuovo file:

  • Selezionare Generale nel riquadro a sinistra.
  • Selezionare Classe vuota nel riquadro centrale.
  • Denominare la classe Movie e selezionare Nuovo.

Aggiungere le proprietà seguenti alla classe Movie:

using System;
using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models
{
    public class Movie
    {
        public int ID { get; set; }
        public string Title { get; set; }

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; }
        public decimal Price { get; set; }
    }
}

La classe Movie contiene:

• Il campo ID è richiesto dal database per la chiave primaria.

• [DataType(DataType.Date)]: l'attributo DataType specifica il tipo di dati (Date). Con questo attributo:

  • l'utente non deve immettere le informazioni temporali nel campo della data.
  • Viene visualizzata solo la data, non le informazioni temporali.

Creare una cartella Pages/Movies:

• Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
• Assegnare alla cartella il nome Movies.

Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo elemento con scaffolding.

Nella finestra di dialogo Aggiungi scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Aggiungi.

Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

• Nel menu a discesa Classe modello selezionare Movie (RazorPagesMovie.Models).
• Nella riga Classe contesto dati selezionare il + segno (più) e modificare il nome generato da RazorPagesMovie.Models. RazorPagesMovieContext in RazorPagesMovie.Dati. RazorPagesMovieContext. Questa modifica non è obbligatoria. Crea la classe del contesto di database con lo spazio dei nomi corretto.
• Selezionare Aggiungi.

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

• Aprire una finestra di comando nella directory del progetto, che contiene i Program.csfile , Startup.cse .csproj .

• Per Windows: eseguire il comando seguente:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages\Movies --referenceScriptLibraries
  

• Per MacOS e Linux: eseguire il comando seguente:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries
  

La tabella seguente illustra in dettaglio le opzioni del generatore di codice core ASP.NET:

Usare l'opzione -h per ottenere informazioni sul dotnet aspnet-codegenerator razorpage comando:

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come inserire in IWebHostEnvironment Startup. IWebHostEnvironment viene inserito in modo da ConfigureServices poter usare SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseDatabaseErrorPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Creare una cartella Pages/Movies:

• Fare clic con il pulsante destro del mouse sulla cartella Pages Aggiungi>nuova cartella.>
• Assegnare alla cartella il nome Movies.

Fare clic con il pulsante destro del mouse sulla cartella> Pages/Movies Aggiungi>nuovo scaffolding....

Nella finestra di dialogo Nuovo scaffolding selezionareRazor Pagine con Entity Framework (CRUD)>Avanti.

Completare la finestra di dialogo Aggiungi Razor pagine usando Entity Framework (CRUD):

• Nell'elenco a discesa Classe modello selezionare o digitare Movie (RazorPagesMovie.Models).
• Nella riga Classe contesto dati digitare il nome della nuova classe RazorPagesMovie.Dati. RazorPagesMovieContext. Questa modifica non è obbligatoria. Crea la classe del contesto di database con lo spazio dei nomi corretto.
• Selezionare Aggiungi.

Il appsettings.json file viene aggiornato con il stringa di connessione utilizzato per connettersi a un database locale.

Aggiungere gli strumenti di Entity Framework

Eseguire il comando seguente dell'interfaccia della riga di comando di .NET:

dotnet tool install --global dotnet-ef

Il comando precedente aggiunge Entity Framework Core Tools per l'interfaccia della riga di comando di .NET. Per altre informazioni, vedere Informazioni di riferimento sugli strumenti di Entity Framework Core - Interfaccia della riga di comando di .NET.

Usare SQLite per lo sviluppo, SQL Server per la produzione

Quando si seleziona SQLite, il codice generato dal modello è pronto per lo sviluppo. Il codice seguente illustra come inserire in IWebHostEnvironment Startup. IWebHostEnvironment viene inserito in modo da ConfigureServices poter usare SQLite in fase di sviluppo e SQL Server nell'ambiente di produzione.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseDatabaseErrorPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Il processo di scaffolding crea e aggiorna i file seguenti:

• Pages/Movies: pagine Create (Crea), Delete (Elimina), Details (Dettagli), Edit (Modifica) e Index (Indice).
• Data/RazorPagesMovieContext.cs

Aggiornato

• Startup.cs

I file creati e aggiornati sono illustrati nella sezione successiva.

Il processo di scaffolding crea e aggiorna i file seguenti:

• Pages/Movies: pagine Create (Crea), Delete (Elimina), Details (Dettagli), Edit (Modifica) e Index (Indice).
• Data/RazorPagesMovieContext.cs

Aggiornato

• Startup.cs

I file creati e aggiornati sono illustrati nella sezione successiva.

Il processo di scaffolding crea i file seguenti:

• Pages/Movies: pagine Create (Crea), Delete (Elimina), Details (Dettagli), Edit (Modifica) e Index (Indice).

I file creati sono illustrati nella sezione successiva.

In questa sezione viene usata la Console di Gestione pacchetti (PMC) per:

• Aggiungere una migrazione iniziale.
• Aggiornare il database con la migrazione iniziale.

Nel menu Strumenti selezionare Gestione pacchetti NuGet>Console di Gestione pacchetti.

Nella Console di Gestione pacchetti immettere i comandi seguenti:

Add-Migration InitialCreate
Update-Database

Se dotnet ef non è stato installato, installarlo come strumento globale:

  dotnet tool install --global dotnet-ef

Per altre informazioni sull'interfaccia della riga di comando per EF Core, vedere EF Core le informazioni di riferimento sugli strumenti per l'interfaccia della riga di comando di .NET.

Eseguire i comandi dell'interfaccia della riga di comando .NET seguenti:

dotnet ef migrations add InitialCreate
dotnet ef database update

Esaminare il contesto registrato con l'inserimento di dipendenze

ASP.NET Core viene compilato con l'inserimento di dipendenze. I servizi, ad esempio il contesto del database, vengono registrati con inserimento delle dipendenze durante l'avvio EF Core dell'applicazione. I componenti che richiedono questi servizi, ad esempio Razor Pages, vengono forniti tramite parametri del costruttore. Più avanti nell'esercitazione viene illustrato il codice del costruttore che ottiene un'istanza del contesto di database.

Lo strumento di scaffolding ha creato automaticamente un contesto di database e lo ha registrato con il contenitore di inserimento delle dipendenze.

Esaminare il metodo Startup.ConfigureServices. La riga evidenziata è stata aggiunta dallo scaffolder:

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

La RazorPagesMovieContext funzionalità delle EF Core coordinate, ad esempio Create, Read, Update e Delete, per il Movie modello. Il contesto dei dati (RazorPagesMovieContext) è derivato da Microsoft.EntityFrameworkCore.DbContext. Il contesto dei dati specifica le entità incluse nel modello di dati.

using Microsoft.EntityFrameworkCore;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (
            DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
    }
}

Il codice precedente crea una proprietà DbSet<Movie> per il set di entità. Nella terminologia di Entity Framework, un set di entità corrisponde in genere alla tabella di un database. Un'entità corrisponde a una riga nella tabella.

Il nome della stringa di connessione viene passato al contesto chiamando un metodo in un oggetto DbContextOptions. Per lo sviluppo locale, il sistema di configurazione legge il stringa di connessione dal appsettings.json file.

Esaminare il metodo Up.