Del 7, lägg till ett nytt fält på en Razor-sida i ASP.NET Core

Av Rick Anderson

I det här avsnittet Entity Framework Core (EF Core) används för att definiera databasschemat baserat på appens modellklass:

• Lägg till ett nytt fält i modellen.
• Migrera den nya fältschemaändringen till databasen.

Den EF Core metoden möjliggör en mer flexibel utvecklingsprocess. Utvecklaren arbetar direkt med appens datamodell medan databasschemat skapas och sedan synkroniseras, allt utan att utvecklaren behöver växla kontexter till och från ett databashanteringsverktyg. En översikt över Entity Framework Core och dess fördelar finns i Entity Framework Core.

Använda EF Code för att automatiskt skapa och spåra en databas:

• Lägger till en __EFMigrationsHistory tabell i databasen för att spåra om schemat för databasen är synkroniserat med de modellklasser som den genererades från.
• Utlöser ett undantag om modellklasserna inte är synkroniserade med databasen.

Automatisk verifiering av att schemat och modellen är synkroniserade gör det enklare att hitta inkonsekventa problem med databaskod.

Lägga till en klassificeringsegenskap i filmmodellen

1. Öppna filen Models/Movie.cs och lägg till en egenskap för Rating:

   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. Redigera Pages/Movies/Index.cshtmloch lägg till ett Rating fält:

   @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. Uppdatera följande sidor med ett Rating fält:

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

Appen fungerar inte förrän databasen har uppdaterats för att inkludera det nya fältet. När du kör appen utan en uppdatering av databasen utlöss en SqlException:

SqlException: Invalid column name 'Rating'.

Undantaget SqlException orsakas av att den uppdaterade filmmodellklassen skiljer sig från schemat för tabellen Film i databasen. Det finns ingen Rating kolumn i databastabellen.

Det finns några metoder för att lösa felet:

1. Låt Entity Framework automatiskt släppa och återskapa databasen med hjälp av det nya modellklassschemat. Den här metoden är praktisk tidigt i utvecklingscykeln, vilket gör att utvecklare snabbt kan utveckla modellen och databasschemat tillsammans. Nackdelen är att befintliga data i databasen går förlorade. Använd inte den här metoden i en produktionsdatabas! Att ta bort databasen vid schemaändringar och använda en initierare för att automatiskt seeda databasen med testdata är ofta ett produktivt sätt att utveckla en app.
2. Ändra uttryckligen schemat för den befintliga databasen så att den matchar modellklasserna. Fördelen med den här metoden är att behålla data. Gör den här ändringen antingen manuellt eller genom att skapa ett databasändringsskript.
3. Använd EF Core Migreringar för att uppdatera databasschemat.

I den här handledningen använder du EF Core Migreringar.

Uppdatera klassen SeedData så att den ger ett värde för den nya kolumnen. En exempeländring visas nedan, men gör den här ändringen för varje new Movie block.

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

Se den slutförda filen SeedData.cs .

Skapa appen

Visual Studio

Tryck på Ctrl+Skift+B

Visual Studio Code

På menyn Visa väljer du Terminal och anger följande kommando:

dotnet build

Visual Studio

Lägga till en migrering för klassificeringsfältet

1. På menyn Verktyg väljer du NuGet Package Manager > Package Manager Console.

2. I Package Manager Console (PMC) anger du följande kommando:

   Add-Migration Rating
   

Kommandot Add-Migration instruerar ramverket att:

• Jämför Movie-modellen med Movie databasschemat.
• Skapa kod för att migrera databasschemat till den nya modellen.

Namnet "Rating" är godtyckligt och används för att namnge migreringsfilen. Det är bra att använda ett beskrivande namn för migreringsfilen.

2. I PMC anger du följande kommando:

   Update-Database
   

Kommandot Update-Database instruerar ramverket att tillämpa schemaändringarna på databasen och bevara befintliga data.

Ta bort alla poster i databasen, initialiseraren kommer att ladda databasen och inkludera fältet Rating. Borttagning kan göras med borttagningslänkarna i webbläsaren eller från Sql Server Object Explorer (SSOX).

Ett annat alternativ är att ta bort databasen och använda migreringar för att återskapa databasen. Så här tar du bort databasen i SSOX:

1. Välj databasen i SSOX.

2. Högerklicka på databasen och välj Ta bort.

3. Kontrollera Stäng befintliga anslutningar.

4. Välj OK.

5. I PMC-uppdaterar du databasen:

   Update-Database
   

Visual Studio Code

Lägga till en migrering för klassificering

Använd följande kommandon för att lägga till en migrering för klassificeringsfältet:

dotnet ef migrations add rating
dotnet ef database update

Kommandot dotnet ef migrations add rating instruerar ramverket att:

• Jämför Movie-modellen med Movie databasschemat.
• Skapa kod för att migrera databasschemat till den nya modellen.

Namnet rating är godtyckligt och används för att namnge migreringsfilen. Det är bra att använda ett beskrivande namn för migreringsfilen.

Kommandot dotnet ef database update instruerar ramverket att tillämpa schemaändringarna på databasen och bevara befintliga data.

Ta bort alla poster i databasen, initieraren kommer att fylla databasen och inkludera fältet Rating.

Valfritt: Ta bort och återskapa databasen för andra leverantörer

Hoppa över det här avsnittet om du har migrerat databasen.

I den här självstudien används Entity Framework Core migreringar funktioner när det är möjligt. Migreringar uppdaterar databasschemat så att det matchar ändringar i datamodellen. Migreringar kan dock bara göra de typer av ändringar som EF Core-providern stöder, och vissa leverantörers funktioner är begränsade. Det kan till exempel finnas stöd för att lägga till en kolumn, men det är inte möjligt att ta bort eller ändra en kolumn. Om en migrering skapas för att ta bort eller ändra en kolumn lyckas kommandot ef migrations add men kommandot ef database update misslyckas. På grund av dessa begränsningar kan du släppa och återskapa databasen.

Lösningen för begränsningarna är att manuellt skriva migreringskod för att utföra en återskapad tabell när något i tabellen ändras. En återskapad tabell omfattar:

• Skapa en ny tabell.
• Kopiera data från den gamla tabellen till den nya tabellen.
• Tar bort det gamla bordet.
• Byter namn på den nya tabellen.

Mer information finns i följande resurser:

• begränsningar för SQLite-EF Core-databasprovider
• Anpassa migreringskod
• Datautsådd
• SQLite ALTER TABLE-instruktion

1. Ta bort migreringsmappen.

2. Använd följande kommandon för att återskapa databasen.

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

Kör appen och kontrollera att du kan skapa, redigera och visa filmer med ett Rating fält. Om databasen inte är seedad anger du en brytpunkt i metoden SeedData.Initialize.

Nästa steg

Föregående: Lägg till söknästa: Lägg till validering