Část 7: Přidání nového pole na Razor stránku v ASP.NET Core

Autor: Rick Anderson

V této části se Entity Framework Core (EF Core) používá k definování schématu databáze na základě třídy modelu aplikace:

• Přidejte do modelu nové pole.
• Migrace nové změny schématu pole do databáze

Přístup EF Core umožňuje agilnější proces vývoje. Vývojář pracuje na datovém modelu aplikace přímo při vytváření a synchronizaci schématu databáze, a to vše bez nutnosti přepínat kontexty do a z nástroje pro správu datbase. Přehled entity Framework Core a jeho výhod najdete v tématu Entity Framework Core.

Použití EF Code k automatickému vytvoření a sledování databáze:

• __EFMigrationsHistory Přidá do databáze tabulku, která sleduje, jestli je schéma databáze synchronizované s třídami modelu, ze které byl vygenerován.
• Vyvolá výjimku, pokud se třídy modelu nesynchronizují s databází.

Automatické ověření, že schéma a model jsou synchronizované, usnadňuje nalezení nekonzistentních problémů s kódem databáze.

Přidání vlastnosti hodnocení do filmového modelu

1. Models/Movie.cs Otevřete soubor a přidejte Rating vlastnost:

   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. Upravit Pages/Movies/Index.cshtmla přidat Rating pole:

   @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. Aktualizujte následující stránky pomocí Rating pole:

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

Aplikace nebude fungovat, dokud se databáze neaktualizuje tak, aby zahrnovala nové pole. Spuštění aplikace bez aktualizace databáze vyvolá SqlExceptionnásledující:

SqlException: Invalid column name 'Rating'.

Výjimka SqlException je způsobena aktualizovanou třídou modelu Movie, která se liší od schématu tabulky Movie databáze. V tabulce databáze není žádný Rating sloupec.

K vyřešení chyby existuje několik přístupů:

1. Rozhraní Entity Framework automaticky vyřaďte a znovu vytvořte databázi pomocí nového schématu třídy modelu. Tento přístup je pohodlný v rané fázi vývojového cyklu, umožňuje vývojářům rychle vyvíjet schéma modelu a databáze společně. Nevýhodou je ztráta existujících dat v databázi. Nepoužívejte tento přístup v produkční databázi. Vyřazení databáze na změny schématu a použití inicializátoru k automatickému sesílání databáze s testovacími daty je často produktivní způsob vývoje aplikace.
2. Explicitně upravte schéma existující databáze tak, aby odpovídalo třídám modelu. Výhodou tohoto přístupu je zachování dat. Tuto změnu proveďte buď ručně, nebo vytvořením skriptu pro změnu databáze.
3. Pomocí EF Core migrací aktualizujte schéma databáze.

Pro účely tohoto kurzu použijte EF Core migrace.

Aktualizujte SeedData třídu tak, aby poskytovala hodnotu pro nový sloupec. Ukázková změna se zobrazí níže, ale proveďte tuto změnu pro každý 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"
    },

Podívejte se na dokončený SeedData.cs soubor.

Vytvoření aplikace

Visual Studio

Stiskněte kombinaci kláves Ctrl+Shift+B.

Visual Studio Code

V nabídce Zobrazit vyberte Terminál a zadejte následující příkaz:

dotnet build

Visual Studio

Přidání migrace pro pole hodnocení

1. V nabídce Nástroje vyberte Správce balíčků konzolu NuGet > Správce balíčků.

2. V konzole Správce balíčků (PMC) zadejte následující příkaz:

   Add-Migration Rating
   

Příkaz Add-Migration říká rozhraní, aby:

• Movie Porovnejte model se schématem Movie databáze.
• Vytvořte kód pro migraci schématu databáze do nového modelu.

Název Hodnocení je libovolný a slouží k pojmenování souboru migrace. Pro soubor migrace je užitečné použít smysluplný název.

2. V PMC zadejte následující příkaz:

   Update-Database
   

Příkaz Update-Database říká rozhraní, aby použil změny schématu v databázi a zachoval existující data.

Odstraňte všechny záznamy v databázi, inicializátor se vloží do databáze a zahrne pole Rating . Odstranění je možné provést pomocí odkazů pro odstranění v prohlížeči nebo z sql serveru Průzkumník objektů (SSOX).

Další možností je odstranit databázi a použít migrace k opětovnému vytvoření databáze. Odstranění databáze v SSOX:

1. Vyberte databázi v SSOX.

2. Klikněte pravým tlačítkem myši na databázi a vyberte Odstranit.

3. Zaškrtněte políčko Zavřít existující připojení.

4. Vyberte OK.

5. V PMC aktualizujte databázi:

   Update-Database
   

Visual Studio Code

Přidání migrace pro hodnocení

K přidání migrace pro pole hodnocení použijte následující příkazy:

dotnet ef migrations add rating
dotnet ef database update

Příkaz dotnet ef migrations add rating říká rozhraní, aby:

• Movie Porovnejte model se schématem Movie databáze.
• Vytvořte kód pro migraci schématu databáze do nového modelu.

rating Název je libovolný a slouží k pojmenování souboru migrace. Pro soubor migrace je užitečné použít smysluplný název.

Příkaz dotnet ef database update říká rozhraní, aby použil změny schématu v databázi a zachoval existující data.

Odstraňte všechny záznamy v databázi, inicializátor se vloží do databáze a zahrne pole Rating .

Volitelné: Vyřaďte a znovu vytvořte databázi pro ostatní poskytovatele.

Pokud jste databázi úspěšně migrovali, přeskočte tuto část.

V tomto kurzu se funkce migrace Entity Framework Core používají, pokud je to možné. Migrace aktualizuje schéma databáze tak, aby odpovídalo změnám datového modelu. Migrace ale můžou provádět pouze druhy změn, které EF Core poskytovatel podporuje, a některé možnosti poskytovatele jsou omezené. Přidání sloupce může být například podporováno, ale odebrání nebo změna sloupce není. Pokud se vytvoří migrace pro odebrání nebo změnu sloupce, příkaz bude úspěšný, ef migrations add ale ef database update příkaz selže. Vzhledem k těmto omezením můžete databázi vypustit a znovu vytvořit.

Alternativním řešením pro omezení je ruční zápis kódu migrace, který provede opětovné sestavení tabulky, když se něco v tabulce změní. Opětovné sestavení tabulky zahrnuje:

• Vytvoření nové tabulky
• Kopírování dat ze staré tabulky do nové tabulky
• Přehození staré tabulky.
• Přejmenování nové tabulky

Další informace naleznete v následujících zdrojích:

• Omezení zprostředkovatele databáze SQLite EF Core
• Přizpůsobení kódu migrace
• Počáteční data
• Příkaz SQLite ALTER TABLE

1. Odstraňte složku migrace.

2. K opětovnému vytvoření databáze použijte následující příkazy.

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

Spusťte aplikaci a ověřte, že můžete vytvářet, upravovat a zobrazovat filmy s polem Rating . Pokud databáze není počáteční, nastavte v SeedData.Initialize metodě zarážku.

Další kroky

Předchozí: Přidat hledánídalší: Přidat ověření