Teil 5: Arbeiten mit einer Datenbank in einer ASP.NET Core MVC-App

Von Rick Anderson und Jon P. Smith.

Das MvcMovieContext-Objekt übernimmt die Aufgabe der Herstellung der Verbindung mit der Datenbank und Zuordnung von Movie-Objekten zu Datensätzen in der Datenbank. Der Datenbankkontext wird beim Dependency Injection-Container in der Datei Program.cs registriert:

Visual Studio

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext")));

Das ASP.NET Core-Konfigurationssystem liest den Schlüssel ConnectionString. Für die lokale Entwicklung wird die Verbindungszeichenfolge aus der Datei appsettings.json abgerufen:

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovieContext-ea7a4069-f366-4742-bd1c-3f753a804ce1.db"
}

Visual Studio Code / Visual Studio für Mac

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

Das ASP.NET Core-Konfigurationssystem liest die ConnectionString. Für die lokale Entwicklung wird die Verbindungszeichenfolge aus der Datei appsettings.json abgerufen:

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

Wenn die App auf einem Test- oder Produktionsserver bereitgestellt wird, kann eine Umgebungsvariable verwendet werden, um die Verbindungszeichenfolge auf einer SQL Server-Produktionsinstanz festzulegen. Weitere Informationen finden Sie unter Konfiguration.

Visual Studio

SQL Server Express LocalDB

LocalDB:

• Ist eine einfache Version der SQL Server Express-Datenbank-Engine, die standardmäßig mit Visual Studio installiert wird.
• Wird bedarfsgesteuert über eine Verbindungszeichenfolge gestartet.
• Ist für die Programmentwicklung ausgerichtet. Wird im Benutzermodus ausgeführt, sodass keine komplexe Konfiguration anfällt.
• Erstellt standardmäßig MDF-Dateien im Verzeichnis C:/Benutzer/{Benutzer} .

Untersuchen der Datenbank

Öffnen Sie im Menü Ansicht den SQL Server-Objekt-Explorer (SSOX).

Klicken Sie mit der rechten Maustaste auf die Tabelle Movie (dbo.Movie), und wählen Sie Ansichts-Designer aus.

Beachten Sie das Schlüsselsymbol neben ID. EF macht die Eigenschaft mit dem Namen ID standardmäßig zum Primärschlüssel.

Klicken Sie mit der rechten Maustaste auf die Tabelle Movie, und wählen Sie Movie aus.

Visual Studio Code / Visual Studio für Mac

SQLite

Auf der SQLite-Website ist zu lesen:

SQLite ist eine eigenständige, sehr zuverlässige, eingebettete, genehmigungsfreie SQL-Datenbank-Engine mit vollem Funktionsumfang. SQLite ist die weltweit am häufigsten verwendete Datenbank-Engine.

Es gibt viele Tools von Drittanbietern, die Sie herunterladen können, um eine SQLite-Datenbank zu verwalten und anzuzeigen. Die folgende Abbildung stammt aus DB Browser for SQLite. Wenn Sie ein bestimmtes SQLite-Tool bevorzugen, geben Sie bitte in einem Kommentar dessen Vorteile an.

Hinweis

Für dieses Tutorial verwenden Sie nach Möglichkeit das Entity Framework Core-Feature Migrationen. Durch Migrationen wird das Datenbankschema so aktualisiert, dass es den Änderungen am Datenmodell entspricht. Migrationen können jedoch nur die Arten von Änderungen durchführen, die der EF Core-Anbieter unterstützt, und die Funktionen des SQLite-Anbieters sind eingeschränkt. So wird beispielsweise das Hinzufügen einer Spalte unterstützt, aber das Entfernen oder Ändern einer Spalte wird nicht unterstützt. Wenn eine Migration zum Entfernen oder Ändern einer Spalte erstellt wird, ist der Befehl ef migrations add erfolgreich, aber der Befehl ef database update schlägt fehl. Aufgrund dieser Einschränkungen verwendet dieses Tutorial keine Migrationen für SQLite-Schemaänderungen. Wenn sich das Schema ändert, löschen Sie stattdessen die Datenbank und erstellen sie erneut.

Die Problemumgehung für die SQLite-Einschränkungen besteht darin, manuell Migrationscode zu schreiben, um das erneute Erstellen einer Tabelle durchzuführen, wenn sich etwas in der Tabelle ändert. Das erneute Erstellen einer Tabelle umfasst die folgenden Aufgaben:

• Erstellen einer neuen Tabelle.
• Kopieren von Daten aus der alten Tabelle in die neue Tabelle.
• Löschen der alten Tabelle.
• Umbenennen der neuen Tabelle.

Weitere Informationen finden Sie in den folgenden Ressourcen:

• Einschränkungen des SQLite-EF Core-Datenbankanbieters
• Anpassen des Migrationscodes
• Datenseeding
• SQLite ALTER TABLE-Anweisung

Ausführen eines Seedings für die Datenbank

Erstellen Sie im Ordner SeedData die neue Klasse SeedData. Ersetzen Sie den generierten Code durch den folgenden:

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

Wenn in der Datenbank Filme vorhanden sind, wird der Initialisierer des Seedings zurückgegeben, und es werden keine Filme hinzugefügt.

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

Hinzufügen des Initialisierers des Seedings

Visual Studio

Ersetzen Sie den Inhalt von Program.cs durch den folgenden Code. Der neue Code ist hervorgehoben.

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

// 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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Löschen Sie alle Datensätze in der Datenbank. Dies ist über die Links „Löschen“ im Browser oder SSOX möglich.

Testen der App. Erzwingen Sie die Initialisierung der App, indem Sie den Code in der Datei Program.cs aufrufen, damit die Seed-Methode ausgeführt wird. Um die Initialisierung zu erzwingen, schließen Sie das Eingabeaufforderungsfenster, das Visual Studio geöffnet hat, und starten Sie es über STRG+F5 neu.

Visual Studio Code / Visual Studio für Mac

Aktualisieren Sie Program.cs mit dem folgenden hervorgehobenen 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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Löschen Sie alle Datensätze in der Datenbank.

Testen der App. Beenden und starten Sie die App neu, damit die SeedData.Initialize-Methode und ein Seeding der Datenbank ausgeführt werden.

Die App zeigt die per Seeding hinzugefügten Daten.

Zurück: Hinzufügen eines ModellsWeiter: Hinzufügen von Controllermethoden und Ansichten