第 7 部分，將新欄位新增至 ASP.NET Core 中的 Razor Page

作者：Rick Anderson

在本節 中，Entity Framework Core （EF Core） 用來根據應用程式的模型類別定義資料庫架構：

• 在模型中新增一個欄位。
• 將新的欄位結構描述變更移轉至資料庫。

此方法 EF Core 允許更敏捷的開發程式。 開發人員直接在應用程式的數據模型上工作，同時建立並同步資料庫架構，而無需開發人員在資料庫管理工具中切換上下文。 如需 Entity Framework Core 的概觀及其優點，請參閱 Entity Framework Core。

使用 EF Code 自動建立及追蹤資料庫：

• 將 __EFMigrationsHistory 資料表新增至資料庫，以追蹤資料庫的結構描述是否與其產生的來源模型類別同步。
• 如果模型類別未與資料庫同步，則會擲回例外狀況。

自動驗證結構描述和模型同步，可讓您更輕鬆地找出不一致的資料庫程式碼問題。

將 Rating 屬性新增至電影模型

1. 開啟 Models/Movie.cs 檔案，並新增 Rating 屬性：

   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.cshtml，並新增 Rating 欄位：

   @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. 使用 Rating 欄位更新下列頁面：

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

在更新資料庫以包含新欄位之前，應用程式無法運作。 在未更新資料庫的情況下執行應用程式，會擲回 SqlException：

SqlException: Invalid column name 'Rating'.

此 SqlException 例外狀況是因為更新的電影模型類別，不同於資料庫之電影資料表的結構描述。 資料庫資料表中沒有任何 Rating 資料行。

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

1. 讓 Entity Framework 自動卸除資料庫，並使用新的模型類別結構描述來重新建立資料庫。 在開發週期早期，這個方法會很方便；其可讓開發人員一併調整模型和資料庫結構描述，更加快速。 缺點是會遺失在資料庫中的現有資料。 請勿在生產環境資料庫上使用此方法！ 在結構描述變更時卸除資料庫以及使用初始設定式將測試資料自動植入資料庫，通常是開發應用程式的有效方式。
2. 您可明確修改現有資料庫的結構描述，使其符合模型類別。 這種方法的優點是能夠保留資料。 手動方式或藉由建立資料庫變更指令碼來進行這項變更。
3. 使用 EF Core 移轉來更新資料庫架構。

在本教學課程中，請使用 EF Core 移轉。

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

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

請參閱完整的 SeedData.cs 檔案 (英文)。

建置應用程式

Visual Studio

按下 Ctrl+Shift+B

Visual Studio Code

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

dotnet build

Visual Studio

新增評等欄位的移轉

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

2. 請在套件管理員主控台 (PMC) 中輸入下列命令：

   Add-Migration Rating
   

Add-Migration 命令會告知架構，以便：

• 比較 Movie 模型與 Movie 資料庫結構描述。
• 建立程式碼，將資料庫結構描述移轉至新模型。

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

2. 在 PMC 中，輸入下列命令：

   Update-Database
   

Update-Database 命令會指示架構將結構描述變更套用至資料庫，並保留現有的資料。

刪除資料庫中的所有記錄，初始設定式會將內容植入資料庫，並包含 Rating 欄位。 可以透過瀏覽器中的刪除連結或 Sql Server 物件總管 (SSOX) 進行刪除。

另一個選擇是刪除資料庫並使用移轉重新建立資料庫。 若要在 SSOX 中刪除資料庫：

1. 在 SSOX 中選取資料庫。

2. 以滑鼠右鍵按一下資料庫，然後選取 [刪除]。

3. 核取 [關閉現有的連接]。

4. 選取 [確定]。

5. 在 PMC 中，更新資料庫：

   Update-Database
   

Visual Studio Code

新增評等的移轉

使用下列命令來新增評等欄位的移轉：

dotnet ef migrations add rating
dotnet ef database update

dotnet ef migrations add rating 命令會告知架構，以便：

• 比較 Movie 模型與 Movie 資料庫結構描述。
• 建立程式碼，將資料庫結構描述移轉至新模型。

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

dotnet ef database update 命令會指示架構將結構描述變更套用至資料庫，並保留現有的資料。

刪除資料庫中的所有記錄，初始設定式會將內容植入資料庫，並包含 Rating 欄位。

選擇性：卸除並重新建立其他提供者的資料庫

如果您已成功移轉資料庫，請略過本節。

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

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

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

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

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

1. 刪除移轉資料夾。

2. 使用下列命令重新建立資料庫。

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

執行應用程式，並驗證您可以使用 Rating 欄位建立、編輯和顯示電影。 若未植入資料庫，請在 SeedData.Initialize 方法中設定中斷點。

下一步

上一步：新增搜尋下一步：新增驗證