Deel 5: werken met een database in een ASP.NET Core MVC-app

Door Rick Anderson en Jon P Smith.

Het MvcMovieContext-object neemt de taak op zich om verbinding te maken met de database en Movie-objecten te koppelen aan databaserecords. De databasecontext is geregistreerd bij de Dependency Injection container in het Program.cs-bestand:

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.")));

Het ASP.NET Core Configuration systeem leest de ConnectionString sleutel. Voor lokale ontwikkeling wordt de verbindingsreeks opgehaald uit het appsettings.json-bestand:

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

Het ASP.NET Core Configuration systeem leest de ConnectionString. Voor lokale ontwikkeling wordt de verbindingsreeks opgehaald uit het appsettings.json-bestand:

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

Waarschuwing

In dit artikel wordt een lokale database gebruikt waarvoor de gebruiker niet hoeft te worden geverifieerd. Productie-apps moeten gebruikmaken van de veiligste verificatiestroom die beschikbaar is. Zie Beveiligde verificatiestromenvoor meer informatie over verificatie voor geïmplementeerde test- en productie-apps.

Visual Studio

SQL Server Express LocalDB

LocalDB:

• Is een lichtgewicht versie van de SQL Server Express Database Engine die standaard is geïnstalleerd met Visual Studio.
• Start op aanvraag met behulp van een verbindingsreeks.
• Is gericht op programmaontwikkeling. Deze wordt uitgevoerd in de gebruikersmodus, dus er is geen complexe configuratie.
• Standaard maakt het .mdf bestanden aan in de map C:/Users/{user}.

De database onderzoeken

Open in het menu WeergaveSQL Server Object Explorer (SSOX).

Klik met de rechtermuisknop op de Movie tabel (dbo.Movie) > Weergaveontwerper

Noteer het sleutelpictogram naast ID. Standaard stelt EF een eigenschap met de naam ID in als de primaire sleutel.

Klik met de rechtermuisknop op de Movie tabel > Gegevens weergeven

Visual Studio Code

SQLite

De SQLite website geeft aan:

SQLite is een zelfstandige, hoogbetrouwbare, ingesloten, volledig uitgeruste SQL-database-engine uit het openbaar domein. SQLite is de meest gebruikte database-engine ter wereld.

Er zijn veel hulpprogramma's van derden die u kunt downloaden om een SQLite-database te beheren en weer te geven. De onderstaande afbeelding is afkomstig uit DB Browser voor SQLite. Als u een favoriet SQLite-hulpprogramma hebt, laat dan een opmerking achter over wat u ervan vindt.

Notitie

Voor deze zelfstudie gebruikt u waar mogelijk de Entity Framework Core migraties functie. Met migraties wordt het databaseschema bijgewerkt zodat het overeenkomt met wijzigingen in het gegevensmodel. Migraties kunnen echter alleen de soorten wijzigingen uitvoeren die de EF Core-provider ondersteunt en de mogelijkheden van de SQLite-provider zijn beperkt. Het toevoegen van een kolom wordt bijvoorbeeld ondersteund, maar het verwijderen of wijzigen van een kolom wordt niet ondersteund. Als er een migratie wordt gemaakt om een kolom te verwijderen of te wijzigen, slaagt de ef migrations add opdracht, maar mislukt de ef database update opdracht. Vanwege deze beperkingen gebruikt deze zelfstudie geen migraties voor SQLite-schemawijzigingen. Wanneer het schema wordt gewijzigd, kunt u de database verwijderen en opnieuw maken.

De tijdelijke oplossing voor de SQLite-beperkingen is het handmatig schrijven van migratiecode om een tabel opnieuw op te bouwen wanneer iets in de tabel verandert. Het opnieuw opbouwen van een tabel omvat:

• Een nieuwe tabel maken.
• Gegevens uit de oude tabel naar de nieuwe tabel kopiëren.
• De oude tafel verwijderen.
• De naam van de nieuwe tabel wijzigen.

Zie de volgende bronnen voor meer informatie:

• beperkingen van SQLite-EF Core-databaseprovider
• migratiecode aanpassen
• Dataseeding
• SQLite ALTER TABLE-instructie

De database vullen

Maak een nieuwe klasse met de naam SeedData in de map Models. Vervang de gegenereerde code door het volgende:

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

Als er films in de database staan, retourneert de seed initializer en worden er geen films toegevoegd.

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

De zaad-initializer toevoegen

Visual Studio

Vervang de inhoud van Program.cs door de volgende code. De nieuwe code is gemarkeerd.

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

Verwijder alle records in de database. U kunt dit doen met de verwijderkoppelingen in de browser of vanuit SSOX.

Test de app. Dwing de app om te initialiseren door de code in het Program.cs-bestand aan te roepen, zodat de seed-methode wordt uitgevoerd. Als u initialisatie wilt afdwingen, sluit u het opdrachtpromptvenster dat Visual Studio heeft geopend en start u opnieuw door op Ctrl+F5 te drukken.

Visual Studio Code

Werk Program.cs bij met de volgende gemarkeerde code:

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

Verwijder alle records in de database.

Test de app. Stop het en start deze opnieuw, zodat de SeedData.Initialize methode wordt uitgevoerd en de database wordt gezaaid.

In de app worden de gezaaide gegevens weergegeven.

Vorige: Een model toevoegenVolgende: Controllermethoden en weergaven toevoegen