7. rész, új mező hozzáadása Razor laphoz a ASP.NET Core-ban

Készítette: Rick Anderson

Ebben a szakaszban Entity Framework Core (EF Core) az adatbázisséma az alkalmazás modellosztálya alapján történő meghatározására szolgál:

• Adjon hozzá egy új mezőt a modellhez.
• Migrálja az új mezőséma-módosítást az adatbázisba.

A EF Core megközelítés lehetővé teszi az agilisabb fejlesztési folyamatot. A fejlesztő közvetlenül az alkalmazás adatmodelljén dolgozik, miközben az adatbázisséma létrejön, majd szinkronizálódik, mindezt anélkül, hogy a fejlesztőnek át kellene váltania a környezeteket egy adatbázis-kezelő eszközre. Az Entity Framework Core és előnyeinek áttekintéséért lásd Entity Framework Core.

Adatbázis automatikus létrehozása és nyomon követése EF Code használatával:

• Hozzáad egy __EFMigrationsHistory táblát az adatbázishoz annak nyomon követéséhez, hogy az adatbázis sémája szinkronban van-e a létrehozott modellosztályokkal.
• Kivételt eredményez, ha a modellosztályok nincsenek szinkronban az adatbázissal.

A séma és a modell szinkronizálásának automatikus ellenőrzése megkönnyíti az adatbáziskódok inkonzisztens hibáinak megtalálását.

Minősítési tulajdonság hozzáadása a filmmodellhez

1. Nyissa meg a Models/Movie.cs fájlt, és adjon hozzá egy Rating tulajdonságot:

   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.cshtmlszerkesztése és Rating mező hozzáadása:

   @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. Frissítse a következő lapokat egy Rating mezővel:

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

Az alkalmazás addig nem működik, amíg az adatbázis nem frissül, hogy tartalmazza az új mezőt. Az alkalmazás frissítés nélküli futtatása az adatbázisra egy SqlExceptionhibát okoz:

SqlException: Invalid column name 'Rating'.

A SqlException kivételt az okozza, hogy a frissített filmmodell-osztály eltér az adatbázis Movie táblájának sémáitól. Nincs Rating oszlop az adatbázistáblában.

A hiba megoldásának néhány módszere van:

1. Az Entity Framework automatikusan elveti és újra létrehozza az adatbázist az új modellosztály-sémával. Ez a megközelítés a fejlesztési ciklus korai szakaszában kényelmes, lehetővé teszi a fejlesztők számára a modell és az adatbázis sémájának gyors fejlesztését. A hátránya az, hogy az adatbázisban meglévő adatok elvesznek. Ne használja ezt a megközelítést éles adatbázisban! Az adatbázis sémamódosításokra való elvetése és az adatbázis automatikus üzembe helyezése tesztadatokkal történő inicializáló használatával gyakran hatékony módszer egy alkalmazás fejlesztésére.
2. Explicit módon módosítsa a meglévő adatbázis sémáját úgy, hogy az megfeleljen a modellosztályoknak. Ennek a megközelítésnek az az előnye, hogy megtartja az adatokat. Végezze el ezt a módosítást manuálisan vagy adatbázis-módosítási szkript létrehozásával.
3. Az adatbázisséma frissítéséhez használja a EF Core migrálásokat.

Ebben az oktatóanyagban használja a EF Core migrálásokat.

Frissítse a SeedData osztályt, hogy értéket adjon az új oszlopnak. Az alábbiakban egy mintamódosítás látható, de végezze el ezt a módosítást az egyes new Movie blokkok esetében.

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

Tekintse meg a befejezett SeedData.cs fájlt.

Az alkalmazás létrehozása

Visual Studio

Nyomja le Ctrl+Shift+B

Visual Studio Code

A Nézet menüben válassza Terminál lehetőséget, és írja be a következő parancsot:

dotnet build

Visual Studio

Migrálás hozzáadása a minősítési mezőhöz

1. Az Eszközök menüben válassza a NuGet Package Manager > Csomagkezelő konzollehetőséget.

2. A Package Manager-konzolon (PMC) adja meg a következő parancsot:

   Add-Migration Rating
   

A Add-Migration parancs a következőre utasítja a keretrendszert:

• Hasonlítsa össze a Movie modellt a Movie adatbázissémával.
• Hozzon létre kódot az adatbázisséma új modellbe való migrálásához.

A "Rating" név tetszőleges, és az áttelepítési fájl elnevezésére szolgál. Hasznos, ha a migrálási fájlnak értelmes nevet ad.

2. A PMC-ben adja meg a következő parancsot:

   Update-Database
   

A Update-Database parancs arra utasítja a keretrendszert, hogy alkalmazza a sémamódosításokat az adatbázisra, és őrizze meg a meglévő adatokat.

Törölje az adatbázis összes rekordját, az inicializáló beállítja az adatbázist és tartalmazza a Rating mezőt. A törlés a böngészőben található törlési hivatkozásokkal vagy Sql Server Object Explorer (SSOX) használatával végezhető el.

Egy másik lehetőség az adatbázis törlése és az áttelepítések használata az adatbázis újbóli létrehozásához. Az adatbázis törlése az SSOX-ban:

1. Válassza ki az adatbázist az SSOX-ban.

2. Kattintson a jobb gombbal az adatbázisra, és válassza a Törléslehetőséget.

3. Ellenőrizze a meglévő kapcsolatok bezárását .

4. Kattintson az OK gombra.

5. Frissítse az adatbázist a PMC-ben:

   Update-Database
   

Visual Studio Code

Adjon hozzá migrációt a minősítéshez

A minősítési mező áttelepítésének hozzáadásához használja az alábbi parancsokat:

dotnet ef migrations add rating
dotnet ef database update

A dotnet ef migrations add rating parancs a következőre utasítja a keretrendszert:

• Hasonlítsa össze a Movie modellt a Movie adatbázissémával.
• Hozzon létre kódot az adatbázisséma új modellbe való migrálásához.

A rating név tetszőleges, és az áttelepítési fájl elnevezésére szolgál. Hasznos, ha a migrálási fájlnak értelmes nevet ad.

A dotnet ef database update parancs arra utasítja a keretrendszert, hogy alkalmazza a sémamódosításokat az adatbázisra, és őrizze meg a meglévő adatokat.

Törölje az adatbázis összes rekordját, az inicializáló beállítja az adatbázist és tartalmazza a Rating mezőt.

Nem kötelező: Az adatbázis elvetése és újbóli létrehozása más szolgáltatók számára

Ha sikeresen migrálta az adatbázist, hagyja ki ezt a szakaszt.

Ebben az oktatóanyagban, amikor lehetséges, az Entity Framework Core migrációk és funkciók kerülnek használatra. A migrálások az adatmodell változásainak megfelelően frissítik az adatbázis sémáját. A migrálások azonban csak a EF Core szolgáltató által támogatott módosításokat hajthatják végre, és egyes szolgáltatók képességei korlátozottak. Előfordulhat például, hogy egy oszlop hozzáadása támogatott, de az oszlopok eltávolítása vagy módosítása nem. Ha egy oszlop eltávolításához vagy módosításához migrálás jön létre, a ef migrations add parancs sikeres lesz, de a ef database update parancs meghiúsul. Ezen korlátozások miatt elvetheti és újra létrehozhatja az adatbázist.

A korlátozások megkerülő megoldása az áttelepítési kód manuális írása a tábla újraépítéséhez, amikor a táblában valami megváltozik. A táblák újraépítése a következőket foglalja magában:

• Új tábla létrehozása.
• Adatok másolása a régi táblából az új táblába.
• A régi asztal elvetése.
• Átnevezi az új táblát.

További információ:

• SQLite EF Core adatbázis-szolgáltatói korlátozások
• Áttelepítési kód testreszabása
• Adatbevetés
• SQLite ALTER TABLE utasítás

1. Törölje az áttelepítési mappát.

2. Az alábbi parancsokkal hozza létre újra az adatbázist.

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

Futtassa az alkalmazást, és ellenőrizze, hogy Rating mezővel hozhat létre, szerkeszthet és jeleníthet meg filmeket. Ha az adatbázis nincs feltöltve, állítson be egy töréspontot a SeedData.Initialize metódusban.

Következő lépések

Előző: Keresés hozzáadásaKövetkező: Érvényesítés hozzáadása