8. rész, új mező hozzáadása egy ASP.NET Core MVC-alkalmazáshoz

Készítette: Rick Anderson

Ebben a szakaszban az entity framework migrations a következőre szolgál:

• Adjon hozzá egy új mezőt a modellhez.
• Az új mező áttelepítése az adatbázisba.

Ha az Entity Framework (EF) használatával automatikusan létrehoz egy adatbázist modellosztályokból:

• A rendszer hozzáad egy táblát az adatbázishoz az adatbázis sémájának nyomon követéséhez.
• A rendszer ellenőrzi, hogy az adatbázis szinkronban van-e a létrehozott modellosztályokkal. Ha nincsenek szinkronban, az EF kivételt jelez. Így könnyebben megtalálhatja az adatbázissal/kóddal kapcsolatos inkonzisztens problémákat.

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

Adj egy Rating tulajdonságot a Models/Movie.cs-hez.

using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace MvcMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }

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

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

Mivel új mezőt adott hozzá az Movie osztályhoz, frissítenie kell a tulajdonságkötési listát, hogy ez az új tulajdonság szerepeljen benne. MoviesController.cs frissítse az [Bind] attribútumot mind a Create és Edit műveleti metódusok esetében a Rating tulajdonság hozzáadásával.

[Bind("Id,Title,ReleaseDate,Genre,Price,Rating")]

Frissítse a nézetsablonokat az új Rating tulajdonság böngészőnézetben való megjelenítéséhez, létrehozásához és szerkesztéséhez.

Szerkessze a /Views/Movies/Index.cshtml fájlt, és adjon hozzá egy Rating mezőt:

<table class="table">
    <thead>
        <tr>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Title)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].ReleaseDate)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Genre)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Price)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Rating)
            </th>
            <th></th>
        </tr>
    </thead>
    <tbody>
        @foreach (var item in Model.Movies!)
        {
            <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-action="Edit" asp-route-id="@item.Id">Edit</a> |
                    <a asp-action="Details" asp-route-id="@item.Id">Details</a> |
                    <a asp-action="Delete" asp-route-id="@item.Id">Delete</a>
                </td>
            </tr>
        }
    </tbody>
</table>

Frissítse a /Views/Movies/Create.cshtml mezőt egy Rating mezővel.

Visual Studio

Másolhatja/beillesztheti az előző "űrlapcsoportot", és az intelliSense segítségével frissítheti a mezőket. Az IntelliSense használható Címkesegédekkel.

Visual Studio Code

Adja hozzá a Rating tulajdonságot a maradék Create.cshtml, Delete.cshtml, Details.cshtml és Edit.cshtml nézet sablonokhoz.

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

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

Az alkalmazás csak akkor működik, ha az adatbázis frissül, hogy az új mezőt is tartalmazza. Ha most fut, a következő SqlException lesz:

SqlException: Invalid column name 'Rating'.

Ez a hiba azért fordul elő, mert a frissített filmmodell-osztály eltér a meglévő adatbázis Movie táblájának sémáitól. (Az adatbázistábla nem Rating tartalmaz oszlopot.)

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 modell osztály séma szerint. Ez a megközelítés nagyon kényelmes a fejlesztési ciklus korai szakaszában, amikor aktív fejlesztést végez egy tesztadatbázison; lehetővé teszi a modell és az adatbázis sémájának gyors együttfejlését. A hátránya azonban az, hogy elveszíti a meglévő adatokat az adatbázisban – ezért nem szeretné ezt a megközelítést éles adatbázisban használni! Az inicializáló használata az adatbázisok automatikus üzembe helyezése tesztadatokkal gyakran hatékony módszer az alkalmazások fejlesztésére. Ez jó módszer a korai fejlesztéshez és az SQLite használatakor.

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 módszernek az az előnye, hogy megtartja az adatait. Ezt a módosítást manuálisan vagy adatbázis-módosítási szkript létrehozásával végezheti el.

3. Az adatbázisséma frissítéséhez használja az Entity Framework Migrations szolgáltatást.

Ebben az oktatóanyagban az Entity Framework Migrationst használjuk.

Visual Studio

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

A Package Manager konzolon adja meg a következő parancsot:

Add-Migration Rating

A Add-Migration parancs arra utasítja a migrálási keretrendszert, hogy vizsgálja meg az aktuális Movie modellt az aktuális Movie DB-sémával, és hozza létre a szükséges kódot a db ú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.

Ha az adatbázis összes rekordja törölve van, az inicializáló metódus beinicializálja az adatbázist, illetve tartalmazza a Rating mezőt.

A Package Manager konzolon adja meg a következő parancsot:

Update-Database

A Update-Database parancs a nem alkalmazott áttelepítéseken futtatja a Fel metódust.

Visual Studio Code

Megjegyzés:

Ebben az oktatóanyagban az Entity Framework Core migrálási funkciót használja, ahol lehetséges. 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 az SQLite-szolgáltató képességei korlátozottak. Például az oszlop hozzáadása támogatott, de az oszlopok eltávolítása vagy módosítása nem támogatott. 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 ez az oktatóanyag nem használ migrálásokat az SQLite-séma módosításaihoz. Ehelyett a séma módosításakor törli és újra létrehozza az adatbázist.

Az SQLite-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.
• Az új tábla átnevezése.

További információt a következő források tartalmaznak:

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

Törölje a Migrations mappát és az adatbázisfájlt, majd futtassa a következő .NET CLI-parancsokat:

dotnet ef migrations add InitialCreate

dotnet ef database update

A részleteket lásd: Az összes migráció alaphelyzetbe állítása.

Futtassa az alkalmazást, és ellenőrizze, hogy Rating mezővel hozhat létre, szerkeszthet és jeleníthet meg filmeket.

ElőzőKövetkező