Teil 2: Hinzufügen eines Modells zu einer Razor Pages-App in ASP.NET Core

In diesem Tutorial werden Klassen für die Verwaltung von Filmen in einer Datenbank hinzugefügt. Die Modellklassen der App verwenden Entity Framework Core (EF Core), um mit der Datenbank zu arbeiten. EF Core ist ein objektrelationaler Mapper (O/RM), der den Datenzugriff vereinfacht. Sie schreiben zuerst die Modellklassen. Anschließend erstellt EF Core die Datenbank.

Die Modellklassen werden als POCO-Klassen (von „Plain-Old CLR Objects“) bezeichnet, da sie keinerlei Abhängigkeit von EF Core aufweisen. Sie definieren die Eigenschaften einer Datei, die in der Datenbank gespeichert ist.

Hinzufügen eines Datenmodells

Visual Studio

1. Klicken Sie im Solution Explorer mit der rechten Maustaste auf das Projekt RazorPagesMovie >Hinzufügen>Neuer Ordner. Geben Sie dem Ordner den Namen Modelsanmelden.

2. Klicken Sie mit der rechten Maustaste auf den Ordner Models. Wählen Sie Hinzufügen>Klasse aus. Nennen Sie die Klasse Movie.

3. Fügen Sie der Klasse Movie die folgenden Eigenschaften hinzu:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

Die Movie-Klasse enthält:

• Die Datenbank benötigt das Feld ID für den primären Schlüssel.

• Ein [DataType]-Attribut, das den Datentyp in der ReleaseDate-Eigenschaft angibt. Mit diesem Attribut:

  • Der Benutzer muss keine Zeitinformationen in das Datumsfeld eingeben.
  • Nur das Datum wird angezeigt, keine Zeitinformationen.

• Das Fragezeichen nach string gibt an, dass die Eigenschaft Nullwerte zulässt. Weitere Informationen finden Sie unter Nullable-Verweistypen.

DataAnnotations werden in einem späteren Tutorial behandelt.

Erstellen Sie das Projekt, um sicherzustellen, dass keine Kompilierungsfehler vorliegen.

Visual Studio Code

1. Fügen Sie einen Ordner mit dem Namen Models hinzu.
2. Fügen Sie zum Ordner Models eine Klasse mit dem Namen Movie.cs hinzu.

Fügen Sie der Klasse Movie die folgenden Eigenschaften hinzu:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

Die Movie-Klasse enthält:

• Ein ID-Feld zum Bereitstellen eines Primärschlüssels für die Datenbank.

• Ein [DataType]-Attribut, das den Datentyp im ReleaseDate-Feld angibt. Mit diesem Attribut:

  • Es ist nicht erforderlich, dass der Benutzer Zeitinformationen in das Datumsfeld eingibt.
  • Nur das Datum wird angezeigt, keine Zeitinformationen.

• Das Fragezeichen nach string gibt an, dass die Eigenschaft Nullwerte zulässt. Weitere Informationen finden Sie unter Nullable-Verweistypen.

DataAnnotations werden in einem späteren Tutorial behandelt.

Hinzufügen von NuGet-Paketen und EF-Tools

Führen Sie die folgenden .NET-CLI-Befehle aus:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

Die oben aufgeführten Befehle fügen Folgendes hinzu:

• Die CLI-Tools für EF Core.
• Das Gerüstbautool „aspnet-codegenerator“.
• Entwurfszeittools für EF Core.
• Den EF Core-SQLite-Anbieter, der das EF Core-Paket als Abhängigkeit installiert.
• Für Gerüstbau erforderliche Pakete: Microsoft.VisualStudio.Web.CodeGeneration.Design und Microsoft.EntityFrameworkCore.SqlServer.

Eine Anleitung für die Konfiguration mehrerer Umgebungen, die es einer App ermöglicht, Ihre Datenbankkontexte nach Umgebung zu konfigurieren, finden Sie unter Verwenden von mehreren Umgebungen in ASP.NET Core.

Hinweis

Standardmäßig stellt die Architektur der zu installierenden .NET-Binärdateien die derzeit ausgeführte Betriebssystemarchitektur dar. Informationen zum Angeben einer anderen Betriebssystemarchitektur finden Sie unter dotnet tool install, --arch option. Weitere Informationen finden Sie unter GitHub Issue dotnet/docs #29262.

Drücken Sie in Visual Studio Code STRG+F5 (Windows) oder ⌘+F5 (macOS), um die App ohne Debugging auszuführen.

Wählen Sie im Panel unterhalb des Editorbereichs die Registerkarte PROBLEME oder im Menü Ansicht die Option Probleme aus, wenn sie sich derzeit nicht in der Ansicht befindet. Stellen Sie sicher, dass keine Kompilierungsfehler aufgetreten sind.

Visual Studio für Mac

1. Klicken Sie im Lösungstoolfenster bei gedrückter Ctrl-Taste auf das Projekt RazorPagesMovie und wählen Sie dann Hinzufügen>Neuer Ordner ... aus. Benennen Sie den Ordner Models.

2. Klicken Sie bei gedrückter Steuerungstaste auf den Ordner Models, und wählen Sie dann Hinzufügen>Neue Klasse... aus.

3. Führen Sie im Dialogfeld Neue Datei folgende Aktionen aus:

   1. Klicken Sie im linken Bereich auf Allgemein.
   2. Klicken Sie im mittleren Bereich auf Leere Klasse.
   3. Geben Sie der Klasse den Namen Movie, und wählen sie Erstellen aus.

4. Fügen Sie der Klasse Movie die folgenden Eigenschaften hinzu:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

Die Movie-Klasse enthält:

• Ein ID-Feld zum Bereitstellen eines Primärschlüssels für die Datenbank.

• Ein [DataType]-Attribut, das den Datentyp im ReleaseDate-Feld angibt. Mit diesem Attribut:

  • Der Benutzer muss keine Zeitinformationen in das Datumsfeld eingeben.
  • Nur das Datum wird angezeigt, keine Zeitinformationen.

DataAnnotations werden in einem späteren Tutorial behandelt.

Erstellen Sie das Projekt, um sicherzustellen, dass keine Kompilierungsfehler vorliegen.

Erstellen des Gerüsts für das Filmmodell

In diesem Abschnitt wird das Gerüst für das Filmmodell erstellt. Mit dem Tool für den Gerüstbau werden Seiten für die Vorgänge „Create“ (Erstellen), „Read“ (Lesen), „Update“ (Aktualisieren) und „Delete“ (Löschen), kurz CRUD-Vorgänge, für das Filmmodell erstellt.

Visual Studio

1. Erstellen Sie den Ordner Pages/Movies:

   1. Klicken Sie mit der rechten Maustaste auf den Ordner Pages>Hinzufügen>Neuer Ordner.
   2. Nennen Sie den Ordner Movies.

2. Klicken Sie mit der rechten Maustaste auf den Ordner Pages/Movies>Hinzufügen>Neues Gerüstelement.

   

3. Wählen Sie im Dialogfeld Neues Gerüst hinzufügen den Eintrag Razor Pages mit Entity Framework (CRUD)>Hinzufügen aus.

   

4. Vervollständigen Sie das Dialogfeld Add Razor Pages using Entity Framework (CRUD) (Razor-Seiten mithilfe des Entity Frameworks (CRUD) hinzufügen):

   1. Wählen Sie in der Dropdownliste Modellklasse den Eintrag Film (RazorPagesMovie.Models) aus.
   2. Wählen Sie in der Zeile Datenkontextklasse das + -Zeichen (Pluszeichen) aus.
      1. Im Dialogfeld Datenkontext hinzufügen wird der Klassenname RazorPagesMovie.Data.RazorPagesMovieContext generiert.
      2. Wählen Sie in der Dropdownliste Datenbankanbieter die Option SQL Server aus.
   3. Wählen Sie Hinzufügen.

   

Die Datei appsettings.json wird mit der Verbindungszeichenfolge aktualisiert, die zum Herstellen einer Verbindung mit einer lokalen Datenbank verwendet wird.

Visual Studio Code

• Öffnen Sie eine Befehlsshell im Projektverzeichnis, das die Dateien Program.cs und .csproj enthält. Führen Sie den folgenden Befehl aus:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

In der folgenden Tabelle sind die Optionen des ASP.NET Core-Codegenerators detailliert aufgeführt.

Option	BESCHREIBUNG
-m	Der Name des Modells.
-dc	Die zu verwendende DbContext-Klasse, einschließlich Namespace.
-udl	Verwendung des Standardlayouts.
-outDir	Der relative Ausgabeordnerpfad zur Erstellung der Ansichten.
--referenceScriptLibraries	Fügt _ValidationScriptsPartial zu den Seiten „Create“ und „Edit“ hinzu.

Über die Option -h können Sie Hilfe zum Befehl dotnet aspnet-codegenerator razorpage erhalten:

dotnet aspnet-codegenerator razorpage -h

Weitere Informationen finden Sie unter dotnet aspnet-codegenerator.

Verwenden von SQLite für die Entwicklung und von SQL Server für die Produktion

Wenn SQLite ausgewählt wurde, ist der von der Vorlage generierte Code für die Entwicklung bereit. Der folgende Code zeigt, wie Sie die SQLite-Verbindungszeichenfolge in der Entwicklung und SQL Server in der Produktion auswählen.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Der Code oben ruft UseDeveloperExceptionPage nicht in der Entwicklung auf, weil WebApplicationUseDeveloperExceptionPage im Entwicklungsmodus aufruft.

Visual Studio für Mac

1. Fügen Sie das NuGet Paket Microsoft.EntityFrameworkCore.Sqlite hinzu, das für das Gerüstbautool erforderlich ist.

   1. Klicken Sie im Lösungstoolfenster bei gedrückter Ctrl-Taste auf das Projekt RazorPagesMovie und wählen Sie dann In Terminal öffnen aus.

   Das Terminalfenster wird mit der Eingabeaufforderung in dem Projektverzeichnis geöffnet, das die Program.cs und .csproj Dateien enthält.

   1. Führen Sie den folgenden .NET-CLI-Befehl aus:

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Erstellen Sie den Ordner Pages/Movies:

   1. Klicken Sie bei gedrückter Steuerungstaste auf den Ordner Pages>Hinzufügen>Neuer Ordner.
   2. Nennen Sie den Ordner Movies.

3. Klicken Sie bei gedrückter Steuerungstaste auf den Ordner Pages/Movies>Hinzufügen>Neuer Gerüstbau aus.

   

4. Klicken Sie im Dialogfeld Add New Scaffolding (Neuen Gerüstbau hinzufügen) auf Razor-Seiten mithilfe des Entity Frameworks (CRUD)>Weiter.

   

5. Vervollständigen Sie das Dialogfeld Add Razor Pages using Entity Framework (CRUD) (Razor-Seiten mithilfe des Entity Frameworks (CRUD) hinzufügen):

   1. Geben Sie in der zu verwendenden ModellklasseMovie ein.
   2. Benennen Sie die Klasse RazorPagesMovie.Data.RazorPagesMovieContext in der Zeile Zu verwendende DbContext-Klasse: .
   3. Wählen Sie Fertig stellen aus.

   

Der Gerüstbauprozess kann einige Zeit in Anspruch nehmen, da erforderliche Pakete automatisch heruntergeladen und dem Projekt hinzugefügt werden.

Die Datei appsettings.json wird mit der Verbindungszeichenfolge aktualisiert, die zum Herstellen einer Verbindung mit einer lokalen Datenbank verwendet wird.

Verwenden von SQLite für die Entwicklung und von SQL Server für die Produktion

Wenn SQLite ausgewählt wurde, ist der von der Vorlage generierte Code für die Entwicklung bereit. Der folgende Code zeigt, wie Sie die SQLite-Verbindungszeichenfolge in der Entwicklung und SQL Server in der Produktion auswählen.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Der Code oben ruft UseDeveloperExceptionPage nicht in der Entwicklung auf, weil WebApplicationUseDeveloperExceptionPage im Entwicklungsmodus aufruft.

Warnung

In diesem Artikel wird eine lokale Datenbank verwendet, für die keine Authentifizierung des Benutzers erforderlich ist. Produktions-Apps sollten den sichersten verfügbaren Ablauf für die Authentifizierung verwenden. Weitere Informationen zur Authentifizierung für bereitgestellte Test- und Produktions-Apps finden Sie unter Sichere Authentifizierungsflows.

Erstellte und aktualisierte Dateien

Der Gerüstbauprozess erstellt die folgenden Dateien:

• Pages/Movies: „Create“, „Delete“, „Details“, „Edit“ und „Index“.
• Data/RazorPagesMovieContext.cs

Die erstellten Daten werden im nächsten Tutorial erläutert.

Der Gerüstbauprozess fügt der Datei Program.cs den folgenden hervorgehobenen Code hinzu:

Visual Studio

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

Visual Studio Code / Visual Studio für Mac

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

Die Änderungen an Program.cs werden später in diesem Tutorial erläutert.

Erstellen des anfängliche, Datenbankschema mithilfe des EF-Features „Migrationen“

Das Feature „Migrationen“ in Entity Framework Core ermöglicht Folgendes:

• Erstellen des anfänglichen Datenbankschemas
• Schrittweises Aktualisieren des Datenbankschemas, um es mit dem Datenmodell der App synchron zu halten. In der Datenbank vorhandene Daten werden beibehalten.

Visual Studio

In diesem Abschnitt wird das Fenster Paket-Manager-Konsole (Package Manager Console, PMC) für Folgendes verwendet:

• Fügen Sie eine anfängliche Migration hinzu.

• Aktualisieren Sie die Datenbank mit der anfänglichen Migration.

• Wählen Sie im Menü Extras die Optionen NuGet-Paket-Manager>Paket-Manager-Konsole aus.

  

• Geben Sie in der PMC den folgenden Befehl ein:

  Add-Migration InitialCreate
  

• Mit dem Befehl Add-Migration wird Code generiert, um das anfängliche Datenbankschema zu erstellen. Das Schema basiert auf dem Modell, das in DbContext angegeben ist. Das Argument InitialCreate wird verwendet, um die Migration zu benennen. Es kann jeder Name verwendet werden, aber per Konvention wird ein Name ausgewählt, der die Migration beschreibt.

Es wird die folgende Warnung angezeigt, die in einem späteren Schritt behandelt wird:

No type was specified for the decimal column 'Price' on entity type 'Movie'. Dadurch werden Werte automatisch abgeschnitten, falls diese nicht der Standardgenauigkeit und -skalierung entsprechen. Explicitly specify the SQL server column type that can accommodate all the values using 'HasColumnType()'. (Für die Spalte „Price“ mit Dezimalwerten für den Entitätstyp „Movie“ wurde kein Typ angegeben. Dadurch werden Werte automatisch abgeschnitten, falls diese nicht der Standardgenauigkeit und -skalierung entsprechen. Geben Sie den Spaltentyp von SQL-Server explizit an, der durch „ForHasColumnType()“ sämtliche Werte unterstützen kann.)

• Geben Sie in der PMC den folgenden Befehl ein:

  Update-Database
  

  Der Update-Database-Befehl führt die Up-Methode in Migrationen aus, die nicht angewendet wurden. In diesem Fall führt der Befehl die Up-Methode in der Datei Migrations/<time-stamp>_InitialCreate.cs aus, mit der die Datenbank erstellt wird.

Visual Studio Code

• Klicken Sie mit der rechten Maustaste auf das Projekt RazorPagesMovie.csproj und wählen Sie dann Im integrierten Terminal öffnen aus.

  Das Terminalfenster wird mit der Eingabeaufforderung in dem Projektverzeichnis geöffnet, das die Program.cs und .csproj Dateien enthält.

• Führen Sie den folgenden .NET-CLI-Befehl aus:

  dotnet ef migrations add InitialCreate
  

  Mit dem Befehl migrations wird Code generiert, um das anfängliche Datenbankschema zu erstellen. Das Schema basiert auf dem Modell, das in DbContext angegeben ist. Das Argument InitialCreate wird verwendet, um die Migrationen zu benennen. Es kann jeder Name verwendet werden, aber per Konvention wird ein Name ausgewählt, der die Migration beschreibt.

• Führen Sie den folgenden .NET-CLI-Befehl aus:

  dotnet ef database update
  

Der update-Befehl führt die Up-Methode in Migrationen aus, die nicht angewendet wurden. In diesem Fall führt update die Up-Methode in der Datei Migrations/<time-stamp>_InitialCreate.cs aus, mit der die Datenbank erstellt wird.

Hinweis

Für SQLite wird der Spaltentyp für das Price-Feld auf TEXT festgelegt. Dies wird in einem späteren Schritt aufgelöst.

Visual Studio für Mac

• Klicken Sie bei gedrückter Ctrl-Taste auf das Projekt RazorPagesMovie und wählen Sie dann In Terminal öffnen aus.

  Das Terminalfenster wird mit der Eingabeaufforderung in dem Projektverzeichnis geöffnet, das die Program.cs und .csproj Dateien enthält.

• Führen Sie die folgenden .NET-CLI-Befehle aus:

  dotnet tool uninstall --global dotnet-ef
  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• Die Befehle tool installieren die neuesten Entity Framework Core-Tools, nachdem Sie alle früheren Versionen deinstalliert haben, sofern diese vorhanden sind.

  Hinweis

  Standardmäßig stellt die Architektur der zu installierenden .NET-Binärdateien die derzeit ausgeführte Betriebssystemarchitektur dar. Informationen zum Angeben einer anderen Betriebssystemarchitektur finden Sie unter dotnet tool install, --arch option. Weitere Informationen finden Sie unter GitHub Issue dotnet/docs #29262.

• Mit dem Befehl migrations wird Code generiert, um das anfängliche Datenbankschema zu erstellen. Das Schema basiert auf dem Modell, das in DbContext angegeben ist. Das Argument InitialCreate wird verwendet, um die Migrationen zu benennen. Es kann jeder Name verwendet werden, aber per Konvention wird ein Name ausgewählt, der die Migration beschreibt.

• Der update-Befehl führt die Up-Methode in Migrationen aus, die nicht angewendet wurden. In diesem Fall führt update die Up-Methode in der Datei Migrations/<time-stamp>_InitialCreate.cs aus, mit der die Datenbank erstellt wird.

Hinweis

Für SQLite wird der Spaltentyp für das Price-Feld auf TEXT festgelegt. Dies wird in einem späteren Schritt aufgelöst.

Es wird die folgende Warnung angezeigt, die in einem späteren Schritt behandelt wird:

No type was specified for the decimal column 'Price' on entity type 'Movie'. Dadurch werden Werte automatisch abgeschnitten, falls diese nicht der Standardgenauigkeit und -skalierung entsprechen. Explicitly specify the SQL server column type that can accommodate all the values using 'HasColumnType()'. (Für die Spalte „Price“ mit Dezimalwerten für den Entitätstyp „Movie“ wurde kein Typ angegeben. Dadurch werden Werte automatisch abgeschnitten, falls diese nicht der Standardgenauigkeit und -skalierung entsprechen. Geben Sie den Spaltentyp von SQL-Server explizit an, der durch „ForHasColumnType()“ sämtliche Werte unterstützen kann.)

Der Datenkontext RazorPagesMovieContext:

• Wird von Microsoft.EntityFrameworkCore.DbContext abgeleitet.
• Gibt an, welche Entitäten im Datenmodell enthalten sind.
• Koordiniert die EF Core-Funktionen (Create, Read, Update und Delete) für das Movie-Modell.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; } = default!;
    }
}

Der vorangehende Code erstellt eine DbSet<Movie>-Eigenschaft für die Entitätenmenge. In der Terminologie von Entity Framework entspricht eine Entitätenmenge in der Regel einer Datenbanktabelle. Entitäten entsprechen Zeilen in Tabellen.

Der Name der Verbindungszeichenfolge wird an den Kontext übergeben, indem Sie eine Methode auf einem DbContextOptions-Objekt aufrufen. Für die lokale Entwicklung liest das -Konfigurationssystem die Verbindungszeichenfolge aus der Datei appsettings.json.

Testen der App

1. Führen Sie die App aus, und fügen Sie /Movies an die URL im Browser an (http://localhost:port/movies).

   Möglicherweise wird eine Fehlermeldung wie diese angezeigt:

   SqlException: Cannot open database "RazorPagesMovieContext-GUID" requested by the login. The login failed.
   Login failed for user 'User-name'.
   

   Sie haben den Migrationsschritt verpasst.

2. Testen Sie den Link Neu erstellen.

   

   Hinweis

   Sie können unter Umständen in das Feld Price keine Kommas als Dezimaltrennzeichen eingeben. Zur Unterstützung der jQuery-Validierung für Gebietsschemas mit einer anderen Sprache als Englisch, in denen ein Komma („,“) als Dezimaltrennzeichen verwendet wird, und für Datums- und Uhrzeitformate, die nicht dem US-englischen Format entsprechen, muss die App globalisiert werden. Globalisierungsanweisungen finden Sie unter GitHub-Problem.

3. Testen Sie die Links Edit (Bearbeiten), Details und Delete (Löschen).

Im nächsten Tutorial finden Sie Erläuterungen zu den Dateien, die durch den Gerüstbau erstellt wurden.

Überprüfen des mit Dependency Injection registrierten Kontexts

ASP.NET Core wird mit Dependency Injection erstellt. Dienste wie der EF Core-Datenbankkontext werden per Dependency Injection beim Anwendungsstart registriert. Komponenten, die diese Dienste erfordern (z. B. Razor Pages), werden über Konstruktorparameter bereitgestellt. Der Konstruktorcode, der eine Datenbankkontextinstanz abruft, wird später in diesem Tutorial erläutert.

Das Tool für den Gerüstbau hat automatisch einen Datenbankkontext erstellt und diesen beim Dependency Injection-Container registriert. Der Datei Program.cs wird der folgende hervorgehobene Code durch den Gerüstbauprozess hinzugefügt:

Visual Studio

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

Visual Studio Code / Visual Studio für Mac

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

Problembehandlung mit dem fertiggestellten Beispiel

Wenn Sie auf ein Problem stoßen, das Sie nicht lösen können, vergleichen Sie Ihren den Code mit dem vollständigen Projekt. Anzeigen oder Herunterladen des fertiggestellten Projekts (Downloadanleitung).

Nächste Schritte

Zurück: Erste SchritteWeiter: Gerüstbau mit Razor Pages