Teil 7: Hinzufügen eines neuen Felds zu einer Razor-Seite in ASP.NET Core

Von Rick Anderson

In diesem Abschnitt werden Entity Framework Code First-Migrationen für folgende Zwecke verwendet:

• Dem Modell wird ein neues Feld hinzugefügt.
• Die neue Änderung am Feldschema wird in die Datenbank migriert.

Bei der Verwendung von EF Code First für die automatische Erstellung und Nachverfolgung einer Datenbank geht Code First wie folgt vor:

• Es fügt der Datenbank eine __EFMigrationsHistory-Tabelle hinzu, um nachzuverfolgen, ob das Schema der Datenbank mit den Modellklassen synchron ist, aus denen sie generiert wurde.
• Wenn die Datenbank mit den Modellklassen nicht synchron ist, wird eine Ausnahme ausgelöst.

Durch die automatische Überprüfung, ob Schema und Modell synchron sind, können Probleme aufgrund inkonsistenter Datenbankencodes leichter ermittelt werden.

Hinzufügen einer Rating-Eigenschaft zum Movie-Modell

1. Öffnen Sie die Datei Models/Movie.cs, und fügen Sie eine Rating-Eigenschaft hinzu:

   public class Movie
   {
       public int Id { get; set; }
       public string Title { get; set; } = string.Empty;
   
       [Display(Name = "Release Date")]
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string Genre { get; set; } = string.Empty;
   
       [Column(TypeName = "decimal(18, 2)")]
       public decimal Price { get; set; }
       public string Rating { get; set; } = string.Empty;
   }
   

2. Bearbeiten Sie Pages/Movies/Index.cshtml, und fügen Sie ein Feld Rating hinzu:

   @page
   @model RazorPagesMovie.Pages.Movies.IndexModel
   
   @{
       ViewData["Title"] = "Index";
   }
   
   <h1>Index</h1>
   
   <p>
       <a asp-page="Create">Create New</a>
   </p>
   
   <form>
       <p>
           <select asp-for="MovieGenre" asp-items="Model.Genres">
               <option value="">All</option>
           </select>
           Title: <input type="text" asp-for="SearchString" />
           <input type="submit" value="Filter" />
       </p>
   </form>
   
   <table class="table">
   
       <thead>
           <tr>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Title)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].ReleaseDate)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Genre)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Price)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Rating)
               </th>
               <th></th>
           </tr>
       </thead>
       <tbody>
           @foreach (var item in Model.Movie)
           {
               <tr>
                   <td>
                       @Html.DisplayFor(modelItem => item.Title)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.ReleaseDate)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.Genre)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.Price)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.Rating)
                   </td>
                   <td>
                       <a asp-page="./Edit" asp-route-id="@item.Id">Edit</a> |
                       <a asp-page="./Details" asp-route-id="@item.Id">Details</a> |
                       <a asp-page="./Delete" asp-route-id="@item.Id">Delete</a>
                   </td>
               </tr>
           }
       </tbody>
   </table>
   

3. Aktualisieren Sie die folgenden Seiten mit einem Rating-Feld:

   • Pages/Movies/Create.cshtml .
   • Pages/Movies/Delete.cshtml .
   • Pages/Movies/Details.cshtml .
   • Pages/Movies/Edit.cshtml .

Die App funktioniert erst, nachdem die Datenbank so aktualisiert wurde, dass sie das neue Feld enthält. Wenn Sie die App ohne eine Aktualisierung der Datenbank ausführen, wird eine SqlException ausgelöst:

SqlException: Invalid column name 'Rating'.

Die SqlException-Ausnahme wird dadurch verursacht, dass sich die aktualisierte Modellklasse „Movie“ vom Schema der Tabelle „Movie“ der Datenbank unterscheidet. Die Datenbanktabelle enthält nicht die Spalte Rating.

Es gibt mehrere Vorgehensweisen zum Beheben des Fehlers:

1. Lassen Sie die Datenbank von Entity Framework automatisch löschen und mit dem neuen Modellklassenschema neu erstellen. Dieser Ansatz ist früh im Entwicklungszyklus sehr praktisch. Er ermöglicht es Entwicklern, das Modell und das Datenbankschema schnell gemeinsam weiterzuentwickeln. Der Nachteil ist, dass in der Datenbank vorhandene Daten verloren gehen. Verwenden Sie diesen Ansatz nicht in einer Produktionsdatenbank! Das Löschen der Datenbank bei Schemaänderungen und das Verwenden eines Initialisierers zum automatischen Ausführen eines Seedings für eine Datenbank mit Testdaten ist häufig eine produktive Möglichkeit zum Entwickeln einer App.
2. Ändern Sie das Schema der vorhandenen Datenbank explizit so, dass es mit den Modellklassen übereinstimmt. Der Vorteil dieses Ansatzes ist, dass Sie Ihre Daten behalten. Sie können diese Änderung entweder manuell oder durch Erstellen eines Skripts zur Änderung der Datenbank vornehmen.
3. Verwenden Sie Code First-Migrationen, um das Datenbankschema zu aktualisieren.

Verwenden Sie für dieses Tutorial Code First-Migrationen.

Aktualisieren Sie die SeedData-Klasse so, dass sie einen Wert für die neue Spalte bereitstellt. Eine Beispieländerung ist nachstehend gezeigt. Nehmen Sie diese Änderung jedoch für jeden new Movie-Block vor.

context.Movie.AddRange(
    new Movie
    {
        Title = "When Harry Met Sally",
        ReleaseDate = DateTime.Parse("1989-2-12"),
        Genre = "Romantic Comedy",
        Price = 7.99M,
        Rating = "R"
    },

Sehen Sie sich die fertige SeedData.cs-Datei an.

Erstellen der App

Visual Studio

Drücken Sie STRG+UMSCHALT+B

Visual Studio Code

Wählen Sie im Menü Ansicht die Option Terminal aus, und geben Sie den folgenden Befehl ein:

dotnet build

Visual Studio für Mac

Drücken Sie ⌘+B

Visual Studio

Hinzufügen einer Migration für das Bewertungsfeld

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

2. Geben Sie in der PMC die folgenden Befehle ein:

   Add-Migration Rating
   Update-Database
   

Der Add-Migration-Befehl weist das Framework an, Folgendes auszuführen:

• Das Modell Movie mit dem Schema der Datenbank Movie vergleichen.
• Erstellen von Code, um das Schema der Datenbank in das neue Modell zu migrieren

Der Name „Rating“ ist beliebig und wird verwendet, um die Migrationsdatei zu benennen. Es ist hilfreich, einen aussagekräftigen Namen für die Migrationsdatei zu verwenden.

Der Update-Database-Befehl weist das Framework an, die Schemaänderungen auf die Datenbank anzuwenden und vorhandene Daten beizubehalten.

Löschen Sie alle Datensätze aus der Datenbank. Dann führt der Initialisierer ein Seeding für die Datenbank aus und fügt das Feld Rating hinzu. Dies ist über die Option „Löschen“ im Browser oder über SQL Server-Objekt-Explorer (SSOX) möglich.

Eine weitere Möglichkeit ist, die Datenbank zu löschen und Migrationen zu verwenden, um die Datenbank neu zu erstellen. So löschen Sie die Datenbank in SSOX

1. Wählen Sie die Datenbank in SSOX aus.

2. Klicken Sie mit der rechten Maustaste auf die Datenbank, und wählen Sie Löschen aus.

3. Aktivieren Sie Vorhandene Verbindungen schließen.

4. Klicken Sie auf OK.

5. Aktualisieren Sie die Datenbank in PMC:

   Update-Database
   

Visual Studio Code / Visual Studio für Mac

Hinzufügen einer Migration zur Bewertung

Verwenden Sie die folgenden Befehle, um eine Migration für das Bewertungsfeld hinzuzufügen:

dotnet ef migrations add rating
dotnet ef database update

Der dotnet-ef migrations add rating-Befehl weist das Framework an, Folgendes auszuführen:

• Das Modell Movie mit dem Schema der Datenbank Movie vergleichen.
• Erstellen von Code, um das Schema der Datenbank in das neue Modell zu migrieren

Der Name rating ist beliebig und wird verwendet, um die Migrationsdatei zu benennen. Es ist hilfreich, einen aussagekräftigen Namen für die Migrationsdatei zu verwenden.

Der dotnet-ef database update-Befehl weist das Framework an, die Schemaänderungen auf die Datenbank anzuwenden und vorhandene Daten beizubehalten.

Löschen Sie alle Datensätze aus der Datenbank. Dann führt der Initialisierer ein Seeding für die Datenbank aus und fügt das Feld Rating hinzu.

Optional: Löschen und erneutes Erstellen der Datenbank für andere Anbieter

Überspringen Sie diesen Abschnitt, wenn Sie die Datenbank erfolgreich migriert haben.

In diesem Tutorial werden nach Möglichkeit Migrationsfeatures von Entity Framework Core verwendet. Durch Migrationen wird das Datenbankschema so aktualisiert, dass es den Änderungen am Datenmodell entspricht. Migrationsvorgänge können jedoch nur die Änderungen durchführen, die der EF Core-Anbieter unterstützt, wobei die Funktionen einiger anderer Anbieter eingeschränkt sind. So kann beispielsweise das Hinzufügen einer Spalte unterstützt werden, aber das Entfernen oder Ändern einer Spalte ist nicht möglich. 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 können Sie die Datenbank löschen und neu erstellen.

Die Problemumgehung für diese Einschränkungen besteht darin, manuell Migrationscode zu schreiben, um eine Tabelle erneut zu erstellen, 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

1. Löschen Sie den Ordner „Migration“.

2. Verwenden Sie die folgenden Befehle, um die Datenbank neu zu erstellen.

   dotnet ef database drop
   dotnet ef migrations add InitialCreate
   dotnet ef database update
   

Führen Sie die App aus, und überprüfen Sie, ob Sie Filme mit dem Feld Rating erstellen, bearbeiten und anzeigen können. Wenn für die Datenbank kein Seed ausgeführt wird, legen Sie einen Haltepunkt in der SeedData.Initialize-Methode fest.

Nächste Schritte

Zurück: Hinzufügen der SucheWeiter: Hinzufügen der Validierung