Část 8: Přidání nového pole do aplikace ASP.NET Core MVC

Autor: Rick Anderson

V této části se migrace Entity Framework používají k:

• Přidejte do modelu nové pole.
• Migrujte nové pole do databáze.

Pokud se entity Framework (EF) používá k automatickému vytvoření databáze z tříd modelů:

• Do databáze se přidá tabulka pro sledování schématu databáze.
• Databáze je ověřena tak, aby byla synchronizovaná s třídami modelu, ze které byla vygenerována. Pokud nejsou synchronizované, ef vyvolá výjimku. To usnadňuje nalezení nekonzistentních problémů s databází nebo kódem.

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

Rating Přidat vlastnost doModels/Movie.cs:

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; }
}

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

Protože jste do Movie třídy přidali nové pole, musíte aktualizovat seznam vazeb vlastností, aby tato nová vlastnost byla zahrnuta. V MoviesController.cs, aktualizovat [Bind] atribut pro obě Create metody Edit akce zahrnout Rating vlastnost:

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

Aktualizujte šablony zobrazení, aby se zobrazila, vytvořila a upravila nová Rating vlastnost v zobrazení prohlížeče.

/Views/Movies/Index.cshtml Upravte soubor a přidejte Rating pole:

<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>

Aktualizujte /Views/Movies/Create.cshtml pole.Rating

Visual Studio

Předchozí skupinu formulářů můžete zkopírovat nebo vložit a nechat intelliSense, aby vám pomohla aktualizovat pole. IntelliSense funguje s pomocnými rutinami značek.

Visual Studio Code

Rating Přidejte vlastnost do zbývajících Create.cshtmlšablon , Delete.cshtmlDetails.cshtml, a Edit.cshtml zobrazit šablony.

Aktualizujte SeedData třídu tak, aby poskytovala hodnotu pro nový sloupec. Níže je uvedena ukázková změna, ale pro každou z nich new Moviebudete chtít provést tuto změnu .

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

Aplikace nebude fungovat, dokud se databáze neaktualizuje tak, aby zahrnovala nové pole. Pokud je teď spuštěný, zobrazí se následující SqlException :

SqlException: Invalid column name 'Rating'.

K této chybě dochází, protože aktualizovaná třída modelu Movie se liší od schématu tabulky Movie existující 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 na základě nového schématu třídy modelu. Tento přístup je velmi pohodlný v rané fázi vývojového cyklu, když provádíte aktivní vývoj v testovací databázi; umožňuje rychle vyvíjet schéma modelu a databáze společně. Nevýhodou ale je, že ztratíte stávající data v databázi , takže tento přístup nechcete používat v produkční databázi! Použití inicializátoru k automatickému sesílování databáze s testovacími daty je často produktivní způsob vývoje aplikace. Tento přístup je vhodný pro raný vývoj a při použití SQLite.

2. Explicitně upravte schéma existující databáze tak, aby odpovídalo třídám modelu. Výhodou tohoto přístupu je, že data uchováváte. Tuto změnu můžete provést ručně nebo vytvořením skriptu pro změnu databáze.

3. K aktualizaci schématu databáze použijte migrace entity Framework.

Pro účely tohoto kurzu se používají migrace entity Framework.

Visual Studio

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

V konzole Správce balíčků zadejte následující příkaz:

Add-Migration Rating

Příkaz Add-Migration informuje architekturu migrace, aby prozkoumal aktuální Movie model s aktuálním Movie schématem databáze a vytvořil potřebný kód pro migraci 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.

Pokud jsou odstraněny všechny záznamy v databázi, inicializace metoda zasadí databázi a zahrne Rating pole.

V konzole Správce balíčků zadejte následující příkaz:

Update-Database

Příkaz Update-Database spustí metodu Up v migracích, které nebyly použity.

Visual Studio Code

Poznámka:

V tomto kurzu použijete funkci migrace Entity Framework Core, 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 možnosti poskytovatele SQLite jsou omezené. Přidání sloupce se například podporuje, ale odebrání nebo změna sloupce se nepodporuje. 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 tento kurz nepoužívá migrace pro změny schématu SQLite. Místo toho, když se schéma změní, vyhodíte databázi a znovu ji vytvoříte.

Alternativním řešením pro omezení SQLite 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

Odstraňte složku Migrations a soubor databáze a spusťte následující příkazy rozhraní příkazového řádku .NET:

dotnet ef migrations add InitialCreate

dotnet ef database update

Další informace najdete v tématu Resetování všech migrací.

Spusťte aplikaci a ověřte, že můžete vytvářet, upravovat a zobrazovat filmy s polem Rating .

PředchozíDalší