Parte 5, usare un database in un'app MVC core ASP.NET

Di Rick Anderson e Jon P Smith.

Introduzione

Questa parte della serie di esercitazioni è incentrata sull'uso di un database SQL nell'applicazione MVC core ASP.NET.

Verrà descritto come:

• Registrare e configurare il contesto del database di Entity Framework Core per l'app ASP.NET Core MVC.
• Usare le stringhe di connessione del database per lo sviluppo locale.
• Usare SQL Server Express LocalDB per lo sviluppo ed esaminare il database e i dati usando Esplora oggetti di SQL Server.
• Eseguire il seeding del database con i dati di esempio iniziali.

Prerequisito

Questa esercitazione usa un database configurato nel passaggio precedente: Parte 4, aggiungere un modello a un'app MVC ASP.NET Core.

Uso del contesto del database

L'oggetto MvcMovieContext gestisce l'attività di connessione al database e di mapping degli oggetti Movie ai record di database. Il contesto del database viene registrato con il contenitore Dependency Injection nel Program.cs file:

Visual Studio

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

Il sistema di configurazione ASP.NET Core legge la ConnectionString chiave. Per lo sviluppo locale, ottiene la stringa di connessione dal file appsettings.json:

"ConnectionStrings": {
  "MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-4ebefa10-de29-4dea-b2ad-8a8dc6bcf374;Trusted_Connection=True;MultipleActiveResultSets=true"
}

Visual Studio Code

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

Il sistema di Configuration di ASP.NET Core legge la ConnectionString. Per lo sviluppo locale, ottiene la stringa di connessione dal file appsettings.json:

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovie.db"
}

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.

Visual Studio

SQL Server Express LocalDB (database locale di SQL Server Express)

Local DB:

• Versione leggera del motore di database SQL Server Express, installata per impostazione predefinita con Visual Studio.
• Inizia su richiesta usando un stringa di connessione.
• È destinato allo sviluppo di programmi. Viene eseguito in modalità utente, quindi non esiste una configurazione complessa.
• Per impostazione predefinita, crea .mdf file nella directory C:/Users/{user}.

Esaminare il database

Dal menu Visualizzazione aprire Esplora oggetti di SQL Server (SSOX).

Fare clic con il pulsante destro del mouse sulla Movie tabella (dbo.Movie) > Visualizzazione Designer

Si noti l'icona a forma di chiave accanto a ID. Per impostazione predefinita, EF crea una proprietà denominata ID chiave primaria.

Fare clic con il pulsante destro del mouse sulla Movie tabella > Visualizza dati

Visual Studio Code

SQLite

Nel sito Web di SQLite si dichiara:

SQLite è un motore di database SQL autonomo, a elevata affidabilità, incorporato, completo e di dominio pubblico. SQLite è il motore di database più usato in tutto il mondo.

Per gestire e visualizzare un database SQLite, sono disponibili numerosi strumenti di terze parti che è possibile scaricare. L'immagine seguente è stata tratta da DB Browser per SQLite. Se si preferisce uno strumento SQLite in particolare, aggiungere un commento sui motivi della preferenza.

Nota

Per questa esercitazione si userà la funzionalità migrazioni di Entity Framework Core laddove possibile. Le migrazioni aggiornano lo schema del database in base alle modifiche nel modello di dati. Tuttavia, le migrazioni possono eseguire solo i tipi di modifiche supportate dal EF Core provider e le funzionalità del provider SQLite sono limitate. Ad esempio l'aggiunta di una colonna è supportata, ma la rimozione o la modifica di una colonna non è supportata. Se si crea una migrazione per rimuovere o modificare una colonna, il comando ef migrations add ha esito positivo, ma il comando ef database update ha esito negativo. A causa di queste limitazioni, in questa esercitazione non vengono usate le migrazioni per le modifiche dello schema di SQLite. In caso di modifiche dello schema, il database viene invece eliminato e ricreato.

La soluzione per ovviare alle limitazioni di SQLite consiste nello scrivere manualmente il codice delle migrazioni per eseguire una ricompilazione della tabella in caso di modifiche nella tabella. La ricostruzione della tabella comporta:

• Creazione di una nuova tabella.
• Copia dei dati dalla vecchia tabella alla nuova tabella.
• Eliminazione della tabella precedente.
• Ridenominazione della nuova tabella.

Per ulteriori informazioni, vedi le seguenti risorse:

• Limitazioni del provider di database SQLite EF Core
• Personalizzare il codice di migrazione
• Popolamento dei dati
• Istruzione ALTER TABLE di SQLite

Specificare il valore di inizializzazione del database

Creare una nuova classe denominata SeedData nella cartella Models. Sostituire il codice generato con il seguente:

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using System;
using System.Linq;

namespace MvcMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new MvcMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<MvcMovieContext>>()))
        {
            // Look for any movies.
            if (context.Movie.Any())
            {
                return;   // DB has been seeded
            }
            context.Movie.AddRange(
                new Movie
                {
                    Title = "When Harry Met Sally",
                    ReleaseDate = DateTime.Parse("1989-2-12"),
                    Genre = "Romantic Comedy",
                    Price = 7.99M
                },
                new Movie
                {
                    Title = "Ghostbusters ",
                    ReleaseDate = DateTime.Parse("1984-3-13"),
                    Genre = "Comedy",
                    Price = 8.99M
                },
                new Movie
                {
                    Title = "Ghostbusters 2",
                    ReleaseDate = DateTime.Parse("1986-2-23"),
                    Genre = "Comedy",
                    Price = 9.99M
                },
                new Movie
                {
                    Title = "Rio Bravo",
                    ReleaseDate = DateTime.Parse("1959-4-15"),
                    Genre = "Western",
                    Price = 3.99M
                }
            );
            context.SaveChanges();
        }
    }
}

Se nel database sono presenti film, l'inizializzatore restituisce e non vengono aggiunti film.

if (context.Movie.Any())
{
    return;  // DB has been seeded.
}

Aggiungere l'inizializzatore del seme

Visual Studio

Sostituire il contenuto di Program.cs con il codice seguente. Il nuovo codice è evidenziato.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/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.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Eliminare tutti i record nel database. È possibile eseguire questa operazione con i collegamenti di eliminazione nel browser o da SSOX.

Test dell'app. Forzare l'inizializzazione dell'app, chiamando il codice nel Program.cs file, in modo che venga eseguito il metodo di inizializzazione. Per forzare l'inizializzazione, chiudere la finestra del prompt dei comandi aperta da Visual Studio e riavviare premendo CTRL+F5.

Visual Studio Code

Eseguire l'aggiornamento Program.cs con il codice evidenziato seguente:

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

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/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.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Eliminare tutti i record nel database.

Test dell'app. Interrompilo e riavvialo in modo che il metodo SeedData.Initialize venga eseguito e popoli il database.

L'app mostra i dati predefiniti.

Precedente: Aggiunta di un modelloSuccessivo: Aggiunta di metodi del controller e viste