Del 5, arbeta med en databas i en ASP.NET Core MVC-app

Av Rick Anderson och Jon P Smith.

Introduction

Den här delen av självstudieserien fokuserar på att arbeta med en SQL-databas i ditt ASP.NET Core MVC-program.

Du får lära dig att:

• Registrera och konfigurera Entity Framework Core-databaskontexten för din ASP.NET Core MVC-app.
• Arbeta med databasanslutningssträngar för lokal utveckling.
• Använd SQL Server Express LocalDB för utveckling och granska din databas och dina data med SQL Server Object Explorer.
• Fyll din databas med inledande exempeldata.

Förutsättning

I den här självstudien används en databas som du konfigurerade i föregående steg: Del 4, lägg till en modell i en ASP.NET Core MVC-app.

Arbeta med databaskontexten

MvcMovieContext-objektet hanterar uppgiften att ansluta till databasen och mappa Movie objekt till databasposter. Databaskontexten registreras med containern Dependency Injection i Program.cs-filen:

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

ASP.NET Core Configuration-systemet läser ConnectionString-nyckeln. För lokal utveckling hämtar den anslutningssträngen från appsettings.json-filen:

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

ASP.NET Core -konfigurationssystemet läser ConnectionString. För lokal utveckling hämtar den anslutningssträngen från appsettings.json-filen:

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

Varning

Den här artikeln använder en lokal databas som inte kräver att användaren autentiseras. Produktionsappar bör använda det säkraste tillgängliga autentiseringsflödet. Mer information om autentisering för distribuerade test- och produktionsappar finns i Säkra autentiseringsflöden.

Visual Studio

SQL Server Express LocalDB

LocalDB:

• Är en lätt version av SQL Server Express Database Engine, installerad som standard med Visual Studio.
• Startar på begäran med hjälp av en anslutningssträng.
• Är inriktat på programutveckling. Den körs i användarläge, så det finns ingen komplex konfiguration.
• Som standard skapas .mdf filer i katalogen C:/Users/{user}.

Granska databasen

Öppna SQL Server Object Explorer (SSOX) på menyn Visa.

Högerklicka på tabellen Movie (dbo.Movie) > View Designer

Observera nyckelikonen bredvid ID. Som standard gör EF en egenskap med namnet ID den primära nyckeln.

Högerklicka på tabellen Movie> Visa data

Visual Studio Code

SQLite

Webbplatsen SQLite uppger:

SQLite är en fristående sql-databasmotor med hög tillförlitlighet, inbäddad, komplett, offentlig domän. SQLite är den mest använda databasmotorn i världen.

Det finns många verktyg från tredje part som du kan ladda ned för att hantera och visa en SQLite-databas. Bilden nedan är från DB Browser for SQLite. Om du har ett SQLite-favoritverktyg lämnar du en kommentar om vad du gillar med det.

Obs

I den här guiden använder du Entity Framework Core migreringsfunktionen där det är möjligt. Migreringar uppdaterar databasschemat så att det matchar ändringar i datamodellen. Migreringar kan dock bara göra de typer av ändringar som EF Core-providern stöder, och SQLite-providerns funktioner är begränsade. Du kan till exempel lägga till en kolumn, men det går inte att ta bort eller ändra en kolumn. Om en migrering skapas för att ta bort eller ändra en kolumn lyckas kommandot ef migrations add men kommandot ef database update misslyckas. På grund av dessa begränsningar använder den här självstudien inte migreringar för SQLite-schemaändringar. När schemat ändras tar du istället bort och återskapar databasen.

Lösningen för SQLite-begränsningarna är att manuellt skriva migreringskod för att utföra en återskapad tabell när något i tabellen ändras. En återskapad tabell omfattar:

• Skapa en ny tabell.
• Kopiera data från den gamla tabellen till den nya tabellen.
• Slänger det gamla bordet.
• Byter namn på den nya tabellen.

Mer information finns i följande resurser:

• begränsningar för SQLite-EF Core-databasprovider
• Anpassa migreringskod
• Dataförodling
• SQLite ALTER TABLE-instruktion

Initiera databasen

Skapa en ny klass med namnet SeedData i mappen Models. Ersätt den genererade koden med följande:

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

Om det finns några filmer i databasen returneras startvärdet och inga filmer läggs till.

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

Lägg till startvärdet för seed

Visual Studio

Ersätt innehållet i Program.cs med följande kod. Den nya koden är markerad.

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

Ta bort alla poster i databasen. Du kan göra detta med borttagningslänkarna i webbläsaren eller från SSOX.

Testa appen. Tvinga appen att initiera och anropa koden i filen Program.cs så att seed-metoden körs. Om du vill framtvinga initiering stänger du kommandotolksfönstret som Visual Studio öppnade och startar om genom att trycka på Ctrl+F5.

Visual Studio Code

Uppdatera Program.cs med följande markerade kod:

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

Ta bort alla poster i databasen.

Testa appen. Stoppa den och starta om den så att SeedData.Initialize-metoden körs och initierar databasen.

Appen visar de data som har matats in.

Föregående: Lägga till en modellNästa: Lägga till kontrollantmetoder och vyer