5. rész: Adatbázis használata egy ASP.NET Core MVC-alkalmazásban

Által Rick Anderson és Jon P Smith.

Bevezetés

Az oktatóanyag-sorozat ezen része az SQL-adatbázis ASP.NET Core MVC-alkalmazásban való használatával foglalkozik.

A következő témákkal fog megismerkedni:

• Regisztrálja és konfigurálja az Entity Framework Core adatbáziskörnyezetét a ASP.NET Core MVC-alkalmazáshoz.
• Helyi fejlesztés során dolgozzon adatbázis-kapcsolati sztringekkel.
• Az SQL Server Express LocalDB használatával fejlesztheti és megvizsgálhatja az adatbázist és az adatokat az SQL Server Object Explorerrel.
• Az adatbázis üzembe helyezése kezdeti mintaadatokkal.

Előfeltétel

Ez az oktatóanyag az előző lépésben beállított adatbázist használja: 4. rész, modell hozzáadása egy ASP.NET Core MVC-alkalmazáshoz.

Az adatbázis-környezet használata

A MvcMovieContext objektum kezeli az adatbázishoz való csatlakozás és Movie objektumok adatbázisrekordokhoz való leképezésének feladatát. Az adatbázis-környezet regisztrálva van a fájl Program.cs tárolójában:

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

A ASP.NET Core Configuration rendszer beolvassa a ConnectionString kulcsot. Helyi fejlesztés esetén lekéri a kapcsolati karakterláncot a appsettings.json fájlból:

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

Az ASP.NET Core Configuration rendszer beolvassa a ConnectionStringfájlt. Helyi fejlesztés esetén lekéri a kapcsolati karakterláncot a appsettings.json fájlból:

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

Figyelmeztetés

Ez a cikk egy helyi adatbázist használ, amely nem igényli a felhasználó hitelesítését. Éles alkalmazások esetén a legbiztonságosabb elérhető hitelesítési folyamatot kell használni. Az üzembe helyezett teszt- és éles alkalmazások hitelesítéséről további információt Biztonságos hitelesítési folyamatokcímű témakörben talál.

Visual Studio

SQL Server Express LocalDB (helyi adatbáziskezelő szoftver)

LocalDB:

• Az SQL Server Express Database Engine egyszerűsített verziója, amely alapértelmezés szerint telepítve van a Visual Studióval.
• Igény szerint elindul egy kapcsolati karakterlánc használatával.
• A programfejlesztésre van megcélzva. Felhasználói módban fut, így nincs összetett konfiguráció.
• Alapértelmezés szerint .mdf fájlokat hoz létre a C:/Users/{user} könyvtárban.

Az adatbázis vizsgálata

A Nézet menüben nyissa meg SQL Server Object Explorer (SSOX).

Kattintson a jobb gombbal a Movie táblára (dbo.Movie) > Nézettervező

Figyelje meg a IDmelletti kulcsikont. Alapértelmezés szerint az EF egy ID nevű tulajdonságot készít az elsődleges kulcsból.

Kattintson a jobb gombbal a Movie táblára > Adatok megtekintése

Visual Studio Code

SQLite

A SQLite webhely a következőt állítja be:

Az SQLite egy önálló, nagy megbízhatóságú, beágyazott, teljes funkcionalitású, nyilvános tartományú SQL-adatbázismotor. Az SQLite a világ leggyakrabban használt adatbázismotorja.

Az SQLite-adatbázisok kezeléséhez és megtekintéséhez számos külső gyártótól származó eszközt tölthet le. Az alábbi kép a(z) DB Browser for SQLite-ből származik. Ha van kedvenc SQLite-eszköze, írja meg kommentben, hogy mit szeret benne.

Jegyzet

Ebben az oktatóanyagban az Entity Framework Core migrálási funkciót használja, ahol lehetséges. A migrálások az adatmodell változásainak megfelelően frissítik az adatbázis sémáját. A migrálások azonban csak a EF Core szolgáltató által támogatott módosításokat hajthatják végre, és az SQLite-szolgáltató képességei korlátozottak. Például az oszlop hozzáadása támogatott, de az oszlopok eltávolítása vagy módosítása nem támogatott. Ha egy oszlop eltávolításához vagy módosításához migrálás jön létre, a ef migrations add parancs sikeres lesz, de a ef database update parancs meghiúsul. Ezen korlátozások miatt ez az oktatóanyag nem használ migrálásokat az SQLite-séma módosításaihoz. A séma módosításakor inkább eldobja és újra létrehozza az adatbázist.

Az SQLite-korlátozások megkerülő megoldása az áttelepítési kód manuális írása a tábla újraépítéséhez, amikor a táblában valami megváltozik. A táblák újraépítése a következőket foglalja magában:

• Új tábla létrehozása.
• Adatok másolása a régi táblából az új táblába.
• A régi asztal elvetése.
• Átnevezi az új táblát.

További információ:

• SQLite EF Core adatbázis-szolgáltatói korlátozások
• Áttelepítési kód testreszabása
• adatbevetési
• SQLite ALTER TABLE utasítás

Az adatbázis üzembe helyezése

Hozzon létre egy SeedData nevű új osztályt a Modellek mappában. Cserélje le a létrehozott kódot a következőre:

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

Ha az adatbázisban vannak filmek, a kezdőérték inicializáló visszatér, és nem adódik hozzá új film.

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

Add meg a mag inicializálót

Visual Studio

Cserélje le a Program.cs tartalmát a következő kódra. Az új kód ki van emelve.

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

Törölje az adatbázis összes rekordjait. Ezt a böngészőben vagy az SSOX-ban található törlési hivatkozásokkal teheti meg.

Tesztelje az alkalmazást. Kényszerítse az alkalmazást az inicializálásra, és hívja meg a kódot a Program.cs fájlban, így a kezdő metódus fut. Az inicializálás kényszerítéséhez zárja be a Visual Studio által megnyitott parancssori ablakot, és indítsa újra a Ctrl+F5 billentyűkombinációt.

Visual Studio Code

Frissítse Program.cs a következő kiemelt kóddal:

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

Törölje az adatbázis összes rekordjait.

Tesztelje az alkalmazást. Állítsa le, majd indítsa újra, hogy a SeedData.Initialize metódus futtassa és magozza az adatbázist.

Az alkalmazás megjeleníti a beszúrt adatokat.

Előző: Modell hozzáadásaKövetkező: Vezérlőmetelyek és nézetek hozzáadása