第 8 部分，將欄位新增至 ASP.NET Core MVC 應用程式

作者：Rick Anderson

在本節中，您會使用 Entity Framework Code First 移轉：

• 在模型中新增一個欄位。
• 將新的欄位移轉至資料庫。

使用 EF Code First 自動建立資料庫時，Code First 會：

• 將資料表新增至資料庫，以追蹤資料庫的結構描述。
• 驗證資料庫與其產生來源的模型類別同步。 如果未同步，EF 會擲回例外狀況。 這可讓您更輕鬆地找出不一致的資料庫/程式碼問題。

將 Rating 屬性新增至電影模型

將 Rating 屬性新增至 Models/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; }
}

建置應用程式

Visual Studio

按下 Ctrl+Shift+B

Visual Studio Code

從 [檢視] 功能表選取 [終端機]，然後輸入下列命令：

dotnet build

Visual Studio for Mac

按下 ⌘+B

因為您已將欄位新增至 Movie 類別，所以需要更新繫結清單，以便包含這個新屬性。 在 MoviesController.cs 中，更新 Create 和 Edit 這兩個動作方法的 [Bind] 屬性 (attribute)，以包括 Rating 屬性 (property)：

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

更新檢視範本，以便在瀏覽器檢視中顯示、建立和編輯新的 Rating 屬性。

編輯 /Views/Movies/Index.cshtml 檔案，並新增 Rating 欄位：

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

使用 Rating 欄位更新 /Views/Movies/Create.cshtml。

Visual Studio / Visual Studio for Mac

您可以複製/貼上前一個「表單群組」，讓 IntelliSense 協助您更新這些欄位。 IntelliSense 會使用標記協助程式。

Visual Studio Code

更新其餘的範本。

更新 SeedData 類別，使其提供新資料行的值。 範例變更如下所示，但您會想要為每個 new Movie 進行這項變更。

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

在更新資料庫以包含新欄位之前，應用程式無法運作。 如果立即執行，則會擲回下列 SqlException：

SqlException: Invalid column name 'Rating'.

此錯誤是因為更新的電影模型類別，不同於現有資料庫之電影資料表的結構描述。 (資料庫資料表中沒有任何 Rating 資料行)。

有幾個方法可以解決這個錯誤：

1. 讓 Entity Framework 自動卸除資料庫，並重新依據新的模型類別結構描述來建立資料庫。 在開發週期早期，當您在測試資料庫上進行開發時，這個方法會很方便；其可讓您一併調整模型和資料庫結構描述，更加快速。 不過，它的缺點是您會遺失資料庫中現有的資料 — 因此您不會想在實際執行的資料庫上使用這種方法！ 使用初始設定式將測試資料自動植入資料庫，通常是開發應用程式的有效方式。 這是早期開發和使用 SQLite 時的好方法。

2. 您可明確修改現有資料庫的結構描述，使其符合模型類別。 這種方法的優點是可以保留您的資料。 您可以手動方式或藉由建立資料庫變更指令碼來進行這項變更。

3. 使用 Code First 移轉來更新資料庫結構描述。

在本教學課程中，請使用 Code First 移轉。

Visual Studio

從 [工具] 功能表中，選取 [NuGet 套件管理員]> [套件管理員主控台]。

在 PMC 中，輸入下列命令：

Add-Migration Rating
Update-Database

Add-Migration 命令會告知移轉架構，檢查目前的 Movie 模型與目前的 Movie 資料庫結構描述，並建立必要的程式碼以將資料庫移轉至新的模型。

"Rating" 是用來命名移轉檔案的任意名稱。 建議您針對移轉檔案使用有意義的名稱，更加實用。

如果刪除資料庫中的所有記錄，初始化方法會將內容植入資料庫，並包含 Rating 欄位。

Visual Studio Code / Visual Studio for Mac

注意

在本教學課程中，請盡可能使用 Entity Framework Core「移轉」功能。 移轉可更新資料庫結構描述，以符合資料模型中的變更。 不過，移轉只能進行 EF Core 提供者支援的變更類型，SQLite 提供者的功能則有限制。 例如，其支援新增資料行，但不支援移除或變更資料行。 如果您建立移轉來移除或變更資料行，ef migrations add 命令會成功，但 ef database update 命令會失敗。 由於這些限制，本教學課程不會將移轉用於 SQLite 結構描述變更。 反之，當結構描述變更時，請您卸除並重新建立資料庫。

SQLite 限制的因應措施是手動撰寫移轉程式碼，以在資料表有所變更時執行資料表重建。 重建資料表包含：

• 建立新的資料表。
• 將資料從舊的資料表複製到新的資料表。
• 卸除舊的資料表。
• 重新命名新資料表。

如需詳細資訊，請參閱以下資源：

• SQLite EF Core 資料庫提供者限制
• 自訂移轉程式碼
• 資料植入
• SQLite ALTER TABLE 陳述式 \(英文\)

刪除 [移轉] 資料夾和資料庫檔案，然後執行下列 .NET CLI 命令：

dotnet ef migrations add InitialCreate

dotnet ef database update

如需詳細資訊，請參閱重設所有移轉。

執行應用程式，並驗證您可以使用 Rating 欄位建立、編輯和顯示電影。

上一個下一個