Deel 7: een nieuw veld toevoegen aan een Razor-pagina in ASP.NET Core

Door Rick Anderson

In deze sectie Entity Framework Core (EF Core) wordt gebruikt om het databaseschema te definiëren op basis van de modelklasse van de app:

• Voeg een nieuw veld toe aan het model.
• Migreer de nieuwe veldschemawijziging naar de database.

De EF Core aanpak maakt een flexibeler ontwikkelproces mogelijk. De ontwikkelaar werkt rechtstreeks aan het gegevensmodel van de app terwijl het databaseschema wordt gemaakt en vervolgens wordt gesynchroniseerd, allemaal zonder dat de ontwikkelaar contexten hoeft over te schakelen naar en van een databasebeheerprogramma. Zie Entity Framework Corevoor een overzicht van Entity Framework Core en de voordelen ervan.

Ef Code gebruiken om automatisch een database te maken en bij te houden:

• Voegt een __EFMigrationsHistory tabel toe aan de database om bij te houden of het schema van de database gesynchroniseerd is met de modelklassen waaruit deze is gegenereerd.
• Genereert een uitzondering als de modelklassen niet zijn gesynchroniseerd met de database.

Automatische verificatie van het schema en model is gesynchroniseerd, waardoor het gemakkelijker is om inconsistente databasecodeproblemen te vinden.

Een classificatie-eigenschap toevoegen aan het filmmodel

1. Open het Models/Movie.cs-bestand en voeg een eigenschap Rating toe:

   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. Pages/Movies/Index.cshtmlbewerken en een Rating veld toevoegen:

   @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>
           <label>Title: <input type="text" asp-for="SearchString" /></label>
           <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. Werk de volgende pagina's bij met een Rating veld:

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

De app werkt pas als de database is bijgewerkt om het nieuwe veld op te nemen. Als u de app uitvoert zonder een update van de database, wordt er een SqlExceptiongegooid.

SqlException: Invalid column name 'Rating'.

De SqlException uitzondering wordt veroorzaakt doordat de bijgewerkte klasse Filmmodel anders is dan het schema van de filmtabel van de database. Er is geen Rating kolom in de databasetabel.

Er zijn enkele benaderingen om de fout op te lossen:

1. Laat Entity Framework de database automatisch verwijderen en opnieuw maken met behulp van het nieuwe modelklasseschema. Deze benadering is vroeg in de ontwikkelingscyclus handig, waardoor ontwikkelaars het model en databaseschema snel samen kunnen ontwikkelen. Het nadeel is dat bestaande gegevens in de database verloren gaan. Gebruik deze methode niet voor een productiedatabase. Het verwijderen van de database bij schemawijzigingen en het gebruik van een initialisatiefunctie om de database automatisch te seeden met testgegevens is vaak een productieve manier om een app te ontwikkelen.
2. Wijzig het schema van de bestaande database expliciet zodat deze overeenkomt met de modelklassen. Het voordeel van deze aanpak is het bewaren van de gegevens. Breng deze wijziging handmatig aan of door een databasewijzigingsscript te maken.
3. Gebruik EF Core Migrations om het databaseschema bij te werken.

Gebruik voor deze zelfstudie EF Core Migraties.

Werk de SeedData-klasse bij zodat deze een waarde voor de nieuwe kolom biedt. Hieronder ziet u een voorbeeldwijziging, maar breng deze wijziging aan voor elk new Movie blok.

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

Zie de voltooide SeedData.cs bestand.

De app bouwen

Visual Studio

Druk op Ctrl+Shift+B

Visual Studio Code

Vanuit het menu Weergave selecteer je Terminal en voer je de volgende opdracht in:

dotnet build

Visual Studio

Een migratie voor het beoordelingsveld toevoegen

1. Selecteer in het menu ToolsNuGet Package Manager > Package Manager Console.

2. Voer in de Package Manager Console (PMC) de volgende opdracht in:

   Add-Migration Rating
   

De opdracht Add-Migration geeft aan dat het framework het volgende moet doen:

• Vergelijk het Movie model met het Movie databaseschema.
• Maak code om het databaseschema naar het nieuwe model te migreren.

De naam Rating is willekeurig en wordt gebruikt om het migratiebestand een naam te geven. Het is handig om een zinvolle naam te gebruiken voor het migratiebestand.

2. Voer in de PMC de volgende opdracht in:

   Update-Database
   

De opdracht Update-Database vertelt het framework om de schemawijzigingen toe te passen op de database en om bestaande gegevens te behouden.

Verwijder alle records in de database, de initialisatiefunctie zal de database seeden en het Rating veld bevatten. Verwijderen kan worden gedaan met de verwijderkoppelingen in de browser of vanuit Sql Server Object Explorer (SSOX).

Een andere optie is om de database te verwijderen en migraties te gebruiken om de database opnieuw te maken. De database verwijderen in SSOX:

1. Selecteer de database in SSOX.

2. Klik met de rechtermuisknop op de database en selecteer verwijderen.

3. Controleer Bestaande verbindingen sluiten.

4. Selecteer OK -.

5. Werk de database bij in de PMC.

   Update-Database
   

Visual Studio Code

Een migratie voor beoordeling toevoegen

Gebruik de volgende opdrachten om een migratie toe te voegen voor het beoordelingsveld:

dotnet ef migrations add rating
dotnet ef database update

De opdracht dotnet ef migrations add rating geeft aan dat het framework het volgende moet doen:

• Vergelijk het Movie model met het Movie databaseschema.
• Maak code om het databaseschema naar het nieuwe model te migreren.

De naam rating willekeurig is en wordt gebruikt om het migratiebestand een naam te geven. Het is handig om een zinvolle naam te gebruiken voor het migratiebestand.

De opdracht dotnet ef database update vertelt het framework om de schemawijzigingen toe te passen op de database en om bestaande gegevens te behouden.

Verwijder alle records in de database, de initialisatiefunctie zal de database seeden en het Rating veld bevatten.

Optioneel: de database voor andere providers verwijderen en opnieuw maken

Sla deze sectie over als u de database hebt gemigreerd.

In deze zelfstudie worden, indien mogelijk, functies van Entity Framework Core migraties gebruikt. Met migraties wordt het databaseschema bijgewerkt zodat het overeenkomt met wijzigingen in het gegevensmodel. Migraties kunnen echter alleen de soorten wijzigingen uitvoeren die de EF Core provider ondersteunt en de mogelijkheden van sommige providers zijn beperkt. Het toevoegen van een kolom kan bijvoorbeeld worden ondersteund, maar het verwijderen of wijzigen van een kolom is dat niet. Als er een migratie wordt gemaakt om een kolom te verwijderen of te wijzigen, slaagt de ef migrations add opdracht, maar mislukt de ef database update opdracht. Vanwege deze beperkingen kunt u de database verwijderen en opnieuw maken.

De tijdelijke oplossing voor de beperkingen is het handmatig schrijven van migratiecode om een tabel opnieuw op te bouwen wanneer iets in de tabel verandert. Het opnieuw opbouwen van een tabel omvat:

• Een nieuwe tabel maken.
• Gegevens uit de oude tabel naar de nieuwe tabel kopiëren.
• De oude tafel verwijderen.
• De naam van de nieuwe tabel wijzigen.

Zie de volgende bronnen voor meer informatie:

• Beperkingen van de SQLite-EF Core-Databaseprovider
• migratiecode aanpassen
• Gegevensinplanting
• SQLite ALTER TABLE-instructie

1. Verwijder de migratiemap.

2. Gebruik de volgende opdrachten om de database opnieuw te maken.

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

Voer de app uit en controleer of u films kunt maken, bewerken en weergeven met een Rating veld. Als de database niet wordt gezaaid, stelt u een onderbrekingspunt in de methode SeedData.Initialize in.

Volgende stappen

Vorige: Zoekfunctie toevoegenVolgende: Validatie toevoegen