Část 5– práce s databází v aplikaci ASP.NET Core MVC

Rick Anderson a Jon P Smith.

Úvod

Tato část série kurzů se zaměřuje na práci s databází SQL ve vaší aplikaci ASP.NET Core MVC.

Co se naučíte:

• Zaregistrujte a nakonfigurujte kontext databáze Entity Framework Core pro vaši aplikaci ASP.NET Core MVC.
• Práce s připojovacími řetězci databáze pro lokální vývoj
• K vývoji použijte SQL Server Express LocalDB a prozkoumejte databázi a data pomocí Průzkumníka objektů SQL Serveru.
• Naplňte svou databázi počátečními vzorovými daty.

Předpoklad

Tento kurz používá databázi, kterou jste nastavili v předchozím kroku: Část 4, přidání modelu do aplikace ASP.NET Core MVC.

Práce s kontextem databáze

Objekt MvcMovieContext zpracovává úlohu připojení k databázi a mapování Movie objektů na záznamy databáze. Kontext databáze je zaregistrovaný v kontejneru pro injektování závislostí v Program.cs souboru.

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

Systém ASP.NET Core Configuration načte ConnectionString klíč. Pro místní vývoj získá připojovací řetězec ze appsettings.json souboru:

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

Systém ASP.NET Core Configuration přečte ConnectionString. Pro místní vývoj získá připojovací řetězec ze appsettings.json souboru:

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

Varování

Tento článek používá místní databázi, která nevyžaduje ověření uživatele. Produkční aplikace by měly používat nejbezpečnější dostupný tok ověřování. Další informace o ověřování nasazených testovacích a produkčních aplikacích vizte Secure authentication flows.

Visual Studio

SQL Server Express LocalDB

LocalDB:

• Je zjednodušená verze databázového stroje SQL Server Express, která je ve výchozím nastavení nainstalovaná se sadou Visual Studio.
• Spustí se na vyžádání pomocí připojovacího řetězce.
• Zaměřuje se na vývoj programů. Běží v uživatelském režimu, takže neexistuje složitá konfigurace.
• Ve výchozím nastavení vytvoří .mdf soubory v adresáři C:/Users/{user}.

Prozkoumání databáze

V nabídce Zobrazení otevřete SQL Server Průzkumník objektů (SSOX).

Klikněte pravým tlačítkem myši na tabulku Movie (dbo.Movie) a vyberte > Návrhář zobrazení

Poznamenejte si ikonu klávesy vedle IDtlačítka . Ef ve výchozím nastavení vytvoří vlastnost s názvem ID primární klíč.

Klikněte pravým tlačítkem myši na Movie tabulku > Zobrazit data.

Visual Studio Code

SQLite

Web SQLite uvádí:

SQLite je samostatný, vysokospolehlivý, vložený, plně funkční databázový engine SQL ve veřejné doméně. SQLite je nejpoužívanější databázový stroj na světě.

Ke správě a zobrazení databáze SQLite můžete stáhnout mnoho nástrojů třetích stran. Následující obrázek je z prohlížeče DB pro SQLite. Pokud máte oblíbený nástroj SQLite, zanechte komentář k tomu, co se vám líbí.

Poznámka:

V tomto kurzu použijete funkci migrace Entity Framework Core, pokud je to možné. Migrace aktualizuje schéma databáze tak, aby odpovídalo změnám datového modelu. Migrace ale můžou provádět pouze druhy změn, které EF Core poskytovatel podporuje, a možnosti poskytovatele SQLite jsou omezené. Přidání sloupce se například podporuje, ale odebrání nebo změna sloupce se nepodporuje. Pokud se vytvoří migrace k odebrání nebo změně sloupce, příkaz ef migrations add je úspěšný, ale příkaz ef database update selže. Vzhledem k těmto omezením tento kurz nepoužívá migrace pro změny schématu SQLite. Místo toho, když se schéma změní, vyhodíte databázi a znovu ji vytvoříte.

Alternativním řešením pro omezení SQLite je ruční zápis kódu migrace, který provede opětovné sestavení tabulky, když se něco v tabulce změní. Opětovné sestavení tabulky zahrnuje:

• Vytvoření nové tabulky
• Kopírování dat ze staré tabulky do nové tabulky
• Přehození staré tabulky.
• Přejmenování nové tabulky

Další informace naleznete v následujících zdrojích:

• Omezení zprostředkovatele databáze SQLite EF Core
• Přizpůsobení kódu migrace
• Seedování dat
• Příkaz SQLite ALTER TABLE

Naplnit databázi

Vytvořte novou třídu pojmenovanou SeedData ve složce Models . Vygenerovaný kód nahraďte následujícím kódem:

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

Pokud jsou v databázi nějaké filmy, počáteční inicializátor se vrátí a žádné filmy nejsou přidány.

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

Přidat inicializátor semen

Visual Studio

Nahraďte obsah Program.cs následujícím kódem. Nový kód je zvýrazněný.

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

Odstraňte všechny záznamy v databázi. Můžete to udělat pomocí odkazů pro odstranění v prohlížeči nebo ze služby SSOX.

Otestujete aplikaci. Vynuťte inicializaci aplikace voláním kódu v souboru Program.cs, aby se spustila metoda seed. Pokud chcete vynutit inicializaci, zavřete okno příkazového řádku, které Visual Studio otevřelo, a restartujte stisknutím kombinace kláves Ctrl+F5.

Visual Studio Code

Aktualizujte Program.cs následujícím zvýrazněným kódem:

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

Odstraňte všechny záznamy v databázi.

Otestujete aplikaci. Zastavte ji a restartujte ji, aby SeedData.Initialize se metoda spustila a zasadí databázi.

Aplikace zobrazuje osetá data.

Předchozí: Přidání modeluDalší: Přidání metod kontroleru a zobrazení