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 . Selezionare 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à . Usando questo attributo:

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

• Un punto interrogativo dopo string indica che la proprietà è nullable. Per ulteriori informazioni, vedere tipi 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 che funge da chiave primaria per il database.

• Attributo [DataType] che specifica il tipo di dati nel ReleaseDate campo. Usando questo attributo:

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

• Un punto interrogativo dopo string indica che la proprietà è nullable. Per ulteriori informazioni, vedere tipi riferimento nullable.

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

Aggiungere i pacchetti NuGet e gli strumenti EF

Esegui i seguenti comandi .NET CLI:

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:

• Gli strumenti dell'interfaccia a riga di comando (CLI) per EF Core
• Lo strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

In Visual Studio Code premere CTRL+F5 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.

1. Nella finestra di dialogo Aggiungi nuovo scaffolding, selezionare RazorPagine che usano Entity Framework (CRUD)>Aggiungi.

1. 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, seleziona SQL Server.
   3. Seleziona Aggiungi.

   

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

• Apri una shell dei comandi nella directory del progetto, che contiene i file Program.cs 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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()
   .WithStaticAssets();

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()
   .WithStaticAssets();
   
app.Run();

In questa sezione usare la finestra 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.

  

• 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 identifica la migrazione. È possibile usare qualsiasi nome, ma per convenzione scegliere un nome che descrive la migrazione.

Viene visualizzato l'avviso seguente, che verrà gestito in un passaggio successivo.

Non è stato specificato alcun tipo di archiviazione per la colonna di tipo decimale 'Price' nel tipo di entità 'Movie'. Questa condizione fa sì che i valori vengano troncati automaticamente se non rientrano nella precisione e nella scala predefinita. Specificare in modo esplicito il tipo di colonna di SQL Server che può contenere tutti i valori in 'OnModelCreating' usando 'HasColumnType', specificare precisione e scala usando 'HasPrecision' o configurare un convertitore di valori usando 'HasConversion'.

• In PMC immettere il comando seguente:

  Update-Database
  

  Il Update-Database comando esegue il Up metodo nelle migrazioni non 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.

  Si apre la finestra Terminal con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e .csproj.

• Esegui il comando .NET CLI seguente:

  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, scegliere un nome che descriva la migrazione.

• Esegui il comando .NET CLI seguente:

  dotnet ef database update
  

  Il update comando esegue il Up metodo nelle migrazioni non 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()
   .WithStaticAssets();

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()
   .WithStaticAssets();
   
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 ulteriori informazioni, vedere tipi 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 ulteriori informazioni, vedere tipi riferimento nullable.

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

Aggiungere i pacchetti NuGet e gli strumenti EF

Esegui i seguenti comandi .NET CLI:

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:

• Gli strumenti dell'interfaccia a riga di comando (CLI) per EF Core
• Lo strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

In Visual Studio Code premere CTRL+F5 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, selezionare RazorPagine che usano 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, seleziona SQL Server.
   3. Seleziona Aggiungi.

   

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

• Apri una shell dei comandi nella directory del progetto, che contiene i file Program.cs 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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'). Ciò comporterà che i valori vengano troncati senza alcuna segnalazione se non rientrano nella precisione e nella 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.

  Si apre la finestra Terminal con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e .csproj.

• Esegui il comando .NET CLI seguente:

  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.

• Esegui il comando .NET CLI seguente:

  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 ulteriori informazioni, vedere tipi 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 ulteriori informazioni, vedere tipi riferimento nullable.

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

Aggiungere i pacchetti NuGet e gli strumenti EF

Esegui i seguenti comandi .NET CLI:

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:

• Gli strumenti dell'interfaccia a riga di comando (CLI) per EF Core
• Lo strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

In Visual Studio Code premere CTRL+F5 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, selezionare RazorPagine che usano 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, seleziona SQL Server.
   3. Seleziona Aggiungi.

   

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

• Apri una shell dei comandi nella directory del progetto, che contiene i file Program.cs 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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'). Ciò comporterà che i valori vengano troncati senza alcuna segnalazione se non rientrano nella precisione e nella 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.

  Si apre la finestra Terminal con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e .csproj.

• Esegui il comando .NET CLI seguente:

  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.

• Esegui il comando .NET CLI seguente:

  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.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 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 ulteriori informazioni, vedere tipi riferimento nullable.

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

Aggiungere i pacchetti NuGet e gli strumenti EF

Esegui i seguenti comandi .NET CLI:

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:

• Gli strumenti dell'interfaccia a riga di comando (CLI) per EF Core
• Lo strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

In Visual Studio Code premere CTRL+F5 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 Soluzione, tenendo premuto CTRL, fare clic sul progetto RazorPagesMovie, quindi selezionare Aggiungi>Nuova cartella.... Assegnare alla cartella il nome Models.

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, selezionare RazorPagine che usano 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, seleziona SQL Server.
   3. Seleziona Aggiungi.

   

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

• Apri una shell dei comandi nella directory del progetto, che contiene i file Program.cs 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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.

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

   1. Esegui il comando .NET CLI seguente:

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Creare una cartella Pages/Movies:

   1. Fai Control-clic sulla cartella Pages>Aggiungi>Nuova cartella.
   2. Assegnare alla cartella il nome Movies.

3. Tenendo premuto Ctrl, fare clic sulla cartella Pages/Movies>Add>New Scaffolding....

   

4. Nella finestra di dialogo Nuovo scaffolding, selezionare RazorPagine con Entity Framework (CRUD)>Avanti.

   

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

   1. Nella riga Classe del modello da usare:, inserisci Movie.
   2. Nella riga Classe DbContext da usare:, assegnare alla classe il nome 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 file appsettings.json viene aggiornato con la stringa di connessione utilizzata 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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 PMC, 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.

  Si apre la finestra Terminal con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e .csproj.

• Esegui i seguenti comandi .NET CLI:

  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.

  Si apre la finestra Terminal con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e .csproj.

• Esegui i seguenti comandi .NET CLI:

  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.

  Note

  Per impostazione predefinita, l'architettura dei file binari .NET da installare rappresenta l'architettura del sistema operativo attualmente in esecuzione. Per specificare un'architettura diversa, vedere come usare il dotnet tool install comando con l'opzione '--arch'. Per ulteriori informazioni, vedere GitHub dotnet/aspnetcore.docs problema n. 29262 - Aggiungere '-a arm64' su Apple Silicon.

• 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 seguenti comandi .NET CLI:

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:

• Gli strumenti dell'interfaccia a riga di comando (CLI) per EF Core
• Lo strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

1. Nella finestra degli strumenti Soluzione, fai clic con il pulsante destro del mouse sul progetto RazorPagesMovie, quindi seleziona Aggiungi>Nuova cartella.... Assegna alla cartella il nome Models.

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 scaffold, selezionare RazorPagine che usano Entity Framework (CRUD)>Aggiungi.

   

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

   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. Seleziona Aggiungi.

   

   Se viene visualizzato un messaggio di errore che indica che è necessario installare il pacchetto Microsoft.EntityFrameworkCore.SqlServer, ripeti i passaggi a partire da Add>New Scaffolded Item.

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

• Apri una shell dei comandi nella directory del progetto, che contiene i file Program.cs 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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, selezionare RazorPagine con Entity Framework (CRUD)>Avanti.

   

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

   1. Nella riga Classe del modello da usare:, inserisci Movie.
   2. Nella riga Classe DbContext da usare:, assegnare alla classe il nome RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Selezionare Fine.

   

Il file appsettings.json viene aggiornato con la stringa di connessione utilizzata 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 mostra come selezionare la stringa di connessione SQLite in fase di sviluppo e usare 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 in fase di 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 PMC, 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.

  Si apre la finestra Terminal con il prompt dei comandi nella directory del progetto, che contiene i file Program.cs e .csproj.

• Esegui i seguenti comandi della CLI di .NET:

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

  Note

  Per impostazione predefinita, l'architettura dei file binari .NET da installare rappresenta l'architettura del sistema operativo attualmente in esecuzione. Per specificare un'architettura diversa, vedere come usare il dotnet tool install comando con l'opzione '--arch'. Per ulteriori informazioni, vedere GitHub dotnet/aspnetcore.docs problema n. 29262 - Aggiungere '-a arm64' su Apple Silicon.

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

Esegui i seguenti comandi .NET CLI:

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:

• Gli strumenti dell'interfaccia a riga di comando (CLI) per EF Core
• Lo strumento di scaffolding aspnet-codegenerator.
• Strumenti in fase di progettazione per EF Core
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

Se si verifica un errore di scaffolding, verifica che il 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 Soluzione, tenendo premuto CTRL, fare clic sul progetto RazorPagesMovie, quindi selezionare Aggiungi>Nuova cartella.... Assegnare alla cartella il nome Models.

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 scaffold, selezionare RazorPagine che usano 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. Seleziona Aggiungi.

   

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

• Apri una shell di comando nella directory del progetto, che contiene i file Program.cs, Startup.cs 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 mostra come inserire IWebHostEnvironment in 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. Fai Control-clic sulla cartella Pages>Aggiungi>Nuova cartella.
   2. Assegnare alla cartella il nome Movies.

2. Tenendo premuto Ctrl, fare clic sulla cartella Pages/Movies>Add>New Scaffolding....

   

3. Nella finestra di dialogo Nuovo scaffolding, selezionare RazorPagine con Entity Framework (CRUD)>Avanti.

   

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

   1. Nella riga Classe DbContext da usare:, assegnare alla classe il nome RazorPagesMovie.Data.RazorPagesMovieContext.
   2. Selezionare Fine.

   

Il file appsettings.json viene aggiornato con la stringa di connessione utilizzata 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 mostra come iniettare IWebHostEnvironment in 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 PMC, immettere i comandi seguenti:

   Add-Migration InitialCreate
   Update-Database
   

• Esegui i seguenti comandi .NET CLI:

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

Esaminare il contesto registrato con l'iniezione delle dipendenze

ASP.NET Core si basa sulla dependency injection. 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 del database e lo ha registrato nel contenitore di dependency injection.

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 funzionalità RazorPagesMovieContext coordina le operazioni EF Core, ad esempio Create, Read, Update e Delete, per il modello Movie. 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 la stringa di connessione dal file appsettings.json.

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

Esegui i seguenti comandi .NET CLI:

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:

• Lo strumento di scaffolding aspnet-codegenerator.
• Gli strumenti di Entity Framework Core per l'interfaccia della riga di comando di .NET.
• Il provider SQLite EF Core, che installa il pacchetto EF Core 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 ASP.NET Ambienti di runtime di base.

Se si verifica un errore di scaffolding, verifica che il 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 Soluzione, tenendo premuto CTRL, fare clic sul progetto RazorPagesMovie, quindi selezionare Aggiungi>Nuova cartella.... Assegnare alla cartella il nome Models.

• 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 scaffold, selezionare RazorPagine che usano 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 a RazorPagesMovie.Data.RazorPagesMovieContext. Questa modifica non è obbligatoria. Crea la classe del contesto del database con il namespace corretto.
• Seleziona Aggiungi.

Il file appsettings.json viene aggiornato con la stringa di connessione utilizzata 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 iniettare IWebHostEnvironment in 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, selezionare RazorPagine con Entity Framework (CRUD)>Avanti.

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

• Nell'elenco a discesa classe Model, selezionare o digitare Movie (RazorPagesMovie.Models).
• Nella riga Classe del contesto dati, digitare il nome della nuova classe, RazorPagesMovie.Data.RazorPagesMovieContext. Questa modifica non è obbligatoria. Crea la classe del contesto del database con il namespace corretto.
• Seleziona Aggiungi.

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

Aggiungi gli strumenti EF

Esegui il comando .NET CLI seguente:

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 iniettare IWebHostEnvironment in 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

Updated

• 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

Updated

• 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 PMC, 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 sulla CLI per EF Core, vedere EF Corele informazioni di riferimento sugli strumenti per la CLI .NET.

Esegui i seguenti comandi .NET CLI:

dotnet ef migrations add InitialCreate
dotnet ef database update

Esaminare il contesto registrato con l'iniezione delle dipendenze

ASP.NET Core si basa sulla dependency injection. 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 del database e lo ha registrato nel contenitore di dependency injection.

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 funzionalità RazorPagesMovieContext coordina le operazioni EF Core, ad esempio Create, Read, Update e Delete, per il modello Movie. 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 la stringa di connessione dal file appsettings.json.

Esaminare il metodo Up.