Parte 4 della serie di esercitazioni sulle Razor pagine

Di Joe Audette

L'oggetto RazorPagesMovieContext 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 in Program.cs:

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

Visual Studio Code/Visual Studio per Mac

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

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

Visual Studio

Il stringa di connessione generato è simile al seguenteJS:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext-bc;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Visual Studio Code/Visual Studio per Mac

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

Quando l'app viene distribuita in un server di test o di produzione, è possibile usare una variabile di ambiente per impostare il stringa di connessione su un server di database di test o di produzione. Per altre informazioni, vedere Configurazione.

Visual Studio

SQL Server Express LocalDB

Local DB è una versione leggera del motore di database di SQL Server Express appositamente pensato per lo sviluppo di programmi. Local DB viene avviato su richiesta ed eseguito in modalità utente; non richiede quindi una configurazione complessa. Per impostazione predefinita, Local DB crea file con estensione *.mdf nella directory C:\Users\<user>\.

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

   

2. Fare clic con il pulsante destro del mouse sulla Movie tabella e scegliere Progettazione viste:

   

   

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

3. Fare clic con il pulsante destro del mouse sulla Movie tabella e scegliere Visualizza dati:

   

Visual Studio Code/Visual Studio per Mac

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.

Sono disponibili molti strumenti di terze parti che è possibile scaricare per gestire e visualizzare un database SQLite. 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, la funzionalità Migrazioni di Entity Framework Core viene usata 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. Al contrario, quando lo schema viene modificato, il database viene 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 ricompilazione 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
• Seeding dei dati
• Istruzione ALTER TABLE di SQLite

Specificare il valore di inizializzazione del database

Creare una nuova classe denominata SeedData nella cartella Models usando il codice seguente:

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;

namespace RazorPagesMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new RazorPagesMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<RazorPagesMovieContext>>()))
        {
            if (context == null || context.Movie == null)
            {
                throw new ArgumentNullException("Null RazorPagesMovieContext");
            }

            // 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 di inizializzazione di inizializzazione restituisce e non vengono aggiunti film.

if (context.Movie.Any())
{
    return;
}

Aggiungere l'inizializzatore del valore di inizializzazione

Program.cs Aggiornare con il codice evidenziato seguente:

Visual Studio

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;
using RazorPagesMovie.Models;

var builder = WebApplication.CreateBuilder(args);

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

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

    SeedData.Initialize(services);
}

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Visual Studio Code/Visual Studio per Mac

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;
using RazorPagesMovie.Models;

var builder = WebApplication.CreateBuilder(args);

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

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

    SeedData.Initialize(services);
}

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Nel codice Program.cs precedente è stata modificata per eseguire le operazioni seguenti:

• Ottenere un'istanza del contesto di database dal contenitore di inserimento delle dipendenze.
• Chiamare il seedData.Initialize metodo passando all'istanza del contesto del database.
• Eliminare il contesto dopo che il metodo di inizializzazione è stato completato. L'istruzione using garantisce che il contesto venga eliminato.

L'eccezione seguente si verifica quando Update-Database non è stata eseguita:

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

Testare l'app

Eliminare tutti i record nel database in modo che venga eseguito il metodo di inizializzazione. Arrestare e avviare l'app per inizializzare il database. Se il database non è sottoposto a seeding, inserire un punto if (context.Movie.Any()) di interruzione ed eseguire il codice.

L'app visualizza i dati sottoposti a seed:

Passaggi successivi

Precedente: Paginecon scaffolding Razor successivo: aggiornare le pagine