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

In questa esercitazione vengono aggiunte classi per la gestione dei film in un database. Le classi di modello dell'app usano Entity Framework Core (EF Core) per lavorare con il database. EF Core è un mapper relazionale a oggetti (O/RM) che semplifica l'accesso ai dati. Per prima cosa si scrivono le classi del modello e EF Core si crea il database.

Le classi del modello sono note come classi POCO (da "Plain-O ld CLR Objects") perché non hanno una dipendenza da EF Core. Definiscono le proprietà dei dati archiviati nel database.

Aggiungere un modello di dati

Visual Studio

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

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

3. Aggiungere le proprietà seguenti alla classe Movie:

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

La classe Movie contiene:

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

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

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

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

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

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

Visual Studio Code

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

Aggiungere le proprietà seguenti alla classe Movie:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

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

La classe Movie contiene:

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

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

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

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

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

Aggiungere i pacchetti NuGet e gli strumenti EF

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

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

I comandi precedenti aggiungono:

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

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

Nota

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

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

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

Eseguire lo scaffolding del modello di filmato

In questa sezione viene eseguito lo scaffolding del modello *Movie*. Lo strumento di scaffolding crea quindi le pagine per le operazioni CRUD (creazione, lettura, aggiornamento ed eliminazione) per il modello di filmato.

Visual Studio

1. Creare la cartella Pages/Movies :

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

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

   

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

   

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

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

   

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

Visual Studio Code

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

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

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

Opzione	Descrizione
-m	Il nome del modello.
-dc	Classe DbContext da usare, incluso lo spazio dei nomi.
-udl	Uso del layout predefinito.
-outDir	Percorso relativo della cartella di output per creare le viste.
--referenceScriptLibraries	Aggiunge _ValidationScriptsPartial per modificare e creare pagine

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

dotnet aspnet-codegenerator razorpage -h

Per altre informazioni, vedere dotnet aspnet-codegenerator.

Usare SQLite per lo sviluppo, SQL Server per la produzione

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

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

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

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

Avviso

Questo articolo usa un database locale che non richiede l'autenticazione dell'utente. Le app di produzione devono usare il flusso di autenticazione più sicuro disponibile. Per altre informazioni sull'autenticazione per le app di test e produzione distribuite, vedere Proteggere i flussi di autenticazione.

File creati e aggiornati

Il processo di scaffolding crea i file seguenti:

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

I file creati sono illustrati nell'esercitazione successiva.

Il processo di scaffolding aggiunge il codice evidenziato seguente al Program.cs file:

Visual Studio

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();

Visual Studio Code

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();

Le Program.cs modifiche vengono illustrate più avanti in questa esercitazione.

Creare lo schema del database iniziale usando la funzionalità di migrazione di Entity Framework

La funzionalità delle migrazioni in Entity Framework Core consente di:

• Creare lo schema del database iniziale.
• Aggiornare in modo incrementale lo schema del database per mantenerlo sincronizzato con il modello di dati dell'app. I dati esistenti nel database sono mantenuti.

Visual Studio

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

• Aggiungere una migrazione iniziale.

• Aggiornare il database con la migrazione iniziale.

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

  

• In PMC immettere il comando seguente:

  Add-Migration InitialCreate
  

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

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

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

• In PMC immettere il comando seguente:

  Update-Database
  

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

Visual Studio Code

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

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

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

  dotnet ef migrations add InitialCreate
  

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

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

  dotnet ef database update
  

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

Nota

Per SQLite, il tipo di colonna per il Price campo è impostato su TEXT. Questo problema viene risolto in un passaggio successivo.

Contesto dati RazorPagesMovieContext:

• Deriva da Microsoft.EntityFrameworkCore.DbContext.
• Specifica le entità incluse nel modello di dati.
• Coordina la EF Core funzionalità, ad esempio Crea, Lettura, Aggiorna ed Elimina, per il Movie modello.

Classe RazorPagesMovieContext nel file Data/RazorPagesMovieContext.csgenerato :

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;

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

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

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

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

Testare l'app

1. Eseguire l'app e accodare /Movies all'URL nel browser (http://localhost:port/movies).

   Se si riceve un messaggio di errore che indica che

   SqlException: Cannot open database "RazorPagesMovieContext-GUID" requested by the login. The login failed.
   Login failed for user 'User-name'.
   

   Non è stato eseguita la migrazione.

2. Testare il collegamento Crea nuovo .

   

   Nota

   Potrebbe non essere possibile immettere virgole decimali nel campo Price. Per supportare la convalida jQuery per impostazioni locali diverse dall'inglese che usano la virgola (",") come separatore decimale e per formati di data diversi da quello dell'inglese (Stati Uniti), è necessario localizzare l'app. Per istruzioni sulla localizzazione, vedere questo problema su GitHub.

3. Testare i collegamenti Modifica, Dettagli ed Elimina.

L'esercitazione successiva illustra i file creati tramite scaffolding.

Esaminare il contesto registrato con l'inserimento di dipendenze

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

Lo strumento di scaffolding ha creato automaticamente un contesto di database e lo ha registrato con il contenitore di inserimento delle dipendenze. Il codice evidenziato seguente viene aggiunto al Program.cs file dallo scaffolder:

Visual Studio

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();

Visual Studio Code

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();

Risoluzione dei problemi con l'esempio completato

Se si verifica un problema che non è possibile risolvere, confrontare il codice con il progetto completato. Visualizzare o scaricare il progetto completato (come scaricare).

Passaggi successivi

Precedente: Introduzione successiva: Pagine con scaffolding Razor