第 2 部分：在 ASP.NET Core 中將模型新增至 Razor Pages 應用程式

在此教程中，您將新增用於管理資料庫中電影的類別。 應用程式的模型類別會使用 Entity Framework Core (EF Core) 來處理資料庫。 EF Core 是可簡化資料存取的物件關聯對應程式 (O/RM)。 您可先撰寫模型類別，然後 EF Core 會建立資料庫。

模型類別稱為 POCO 類別（源自「Plain-Old CLR Objects」），因為它們不相依於 EF Core。 它們會定義資料儲存在資料庫中的屬性。

新增資料模型

Visual Studio

1. 在 解決方案總管中，右鍵點擊 RazorPagesMovie 專案。 選擇 新增>新資料夾。 將資料夾命名為 Models。

2. 以滑鼠右鍵按一下 Models 資料夾。 選取 新增>類別。 將類別命名為 Movie。

3. 將下列屬性新增至 Movie 類別：

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

Movie 類別包含：

• ID 欄位是資料庫對於主索引鍵的必要欄位。

• [DataType] 屬性，指定 ReleaseDate 屬性中的資料型別。 透過使用此屬性：

  • 使用者不需要在日期欄位中輸入時間資訊。
  • 僅顯示日期，沒有時間資訊。

• 之後 string 加問號表示該性質可為零。 如需詳細資料，請參閱 可為 Null 的參考型別。

稍後的教學課程會涵蓋 DataAnnotations。

建置專案，以確認沒有任何編譯錯誤。

Visual Studio 程式碼

1. 新增名為 Models 的資料夾。
2. 將類別新增至名為 Models 的 Movie.cs 資料夾。

將下列屬性新增至 Movie 類別：

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

Movie 類別包含：

• 一個 ID 作為資料庫主鍵的欄位。

• 一個 [DataType] 屬性，用來指定欄位中 ReleaseDate 資料的類型。 透過使用此屬性：

  • 使用者不需要在日期欄位輸入時間資訊。
  • 僅顯示日期，沒有時間資訊。

• 之後 string 加問號表示該性質可為零。 如需詳細資料，請參閱 可為 Null 的參考型別。

稍後的教學課程會涵蓋 DataAnnotations。

新增 NuGet 套件和 EF 工具

執行下列 .NET CLI 命令：

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

上述命令會新增：

• 適用於 EF Core 的命令列介面 (CLI) 工具
• aspnet-codegenerator 樣板產生工具。
• 適用於 EF Core 的設計階段工具
• EF Core SQLite 提供者，該提供者會將 EF Core 套件作為相依性安裝。
• 建立樣板所需的套件：Microsoft.VisualStudio.Web.CodeGeneration.Design 和 Microsoft.EntityFrameworkCore.SqlServer。

如需允許應用程式依環境設定其資料庫內容的多個環境設定的指引，請參閱 ASP.NET Core 執行階段環境。

Note

預設情況下，安裝的 .NET 二進位架構代表目前執行的作業系統架構。 若要指定不同的架構，請檢視如何使用帶有dotnet tool install的指令。 更多資訊請參見 GitHub dotnet/aspnetcore.docs issue #29262 - 在 Apple Silicon 上新增 '-a arm64'。

在 Visual Studio Code 中，按 Ctrl+F5 執行應用程式但不進行偵錯。

在編輯器區域下方的 面板 中，選擇 「問題 」標籤，或在 檢視 選單中選擇 「問題 」，如果目前不在視野中。 確認沒有編譯錯誤。

為影片模型建立樣板

在這個章節中，你架起了電影模型。 鷹架工具為電影模型產生建立、讀取、更新與刪除（CRUD）操作的頁面。

Visual Studio

1. 建立 Pages/Movies 資料夾：

   1. 以滑鼠右鍵按一下 Pages 資料夾 >[新增]>[新增資料夾]。
   2. 將資料夾命名為 Movies。

2. 以滑鼠右鍵按一下 Pages/Movies 資料夾 >[新增]>[新增 Scaffolded 項目]。

1. 在 新增 Scaffold 對話方塊中，選取 使用 Entity Framework 的 RazorPages (CRUD)>新增。

1. 完成 使用 Entity Framework (CRUD) 新增Razor頁面 對話方塊：

   1. 在 Model class 下拉式清單中，選取 Movie (RazorPagesMovie.Models)。
   2. 在 資料內容類別 列中，選取 +（加號）。
      1. 在 [新增資料內容] 對話方塊中，即會產生類別名稱 RazorPagesMovie.Data.RazorPagesMovieContext。
      2. 在 [資料庫提供者] 下拉式清單中，選取 [SQL Server]。
   3. 選取 ，然後新增。

   

appsettings.json 檔案會更新為包含用於連線至本機資料庫的連接字串。

Visual Studio 程式碼

• 在包含 Program.cs 和 .csproj 檔案的專案目錄中開啟命令列。 執行以下命令：

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

下表詳述 ASP.NET 核心程式碼產生器的選項。

Option	Description
-m	模型的名稱。
-dc	DbContext 類別，用來包含命名空間。
-udl	使用預設的配置。
-outDir	用來建立檢視的相對輸出資料夾路徑。
--referenceScriptLibraries	將 _ValidationScriptsPartial 新增至 Edit 和 Create 頁面

使用 -h 選項取得關於 dotnet aspnet-codegenerator razorpage 命令的說明：

dotnet aspnet-codegenerator razorpage -h

如需詳細資訊，請參閱 dotnet aspnet-codegenerator。

使用 SQLite 進行開發，SQL Server 用於實際執行環境

選取 SQLite 時，範本產生的程式碼已準備好進行開發。 下列程式碼示範如何在開發環境中選取 SQLite 連接字串，以及在實際執行環境中選取 SQL Server。

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

上述程式碼不會在開發環境中呼叫 UseDeveloperExceptionPage，因為 WebApplication 會在開發環境中呼叫 UseDeveloperExceptionPage。

Warning

本文使用本機資料庫，其不需要使用者進行驗證。 實際執行應用程式應該使用可用的最安全驗證流程。 如需已部署測試與實際執行應用程式驗證的詳細資訊，請參閱安全驗證流程。

建立和更新的檔案

樣板流程會建立下列檔案：

• Pages/Movies：建立、刪除、詳細資料、編輯和索引。
• Data/RazorPagesMovieContext.cs

下一個教學會解釋所建立的檔案。

Scaffold 程序會將下列醒目提示的程式碼新增至 Program.cs 檔案：

Visual Studio

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();

app.Run();

Visual Studio 程式碼

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();
   
app.Run();

在這個教學的後半段，你會了解這些 Program.cs 變更。

利用 EF 的遷移功能建立初始資料庫架構

Entity Framework Core 中的移轉功能讓您可以：

• 建立初始資料庫結構描述。
• 以累加方式更新資料庫結構描述，以便與應用程式的資料模型保持同步。 此方法保留資料庫中的現有資料。

Visual Studio

在此區段中，請使用 套件管理員主控台 （PMC）視窗來：

• 新增初始移轉。

• 使用初始移轉來更新資料庫。

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

  

• 在 PMC 中，輸入下列命令：

  Add-Migration InitialCreate
  

• Add-Migration 命令會產生程式碼來建立初始資料庫結構描述。 結構描述是以 DbContext 中指定的模型為基礎。 這個 InitialCreate 參數命名了遷移。 你可以用任何名字，但依慣例選擇一個能描述遷移過程的名字。

會顯示以下警告，請稍後處理：

實體類型「Movie」的「Price」小數欄未指定商店類型。 此條件會導致若值不符合預設精度與縮放範圍，則會被靜默截斷。 可明確指定可容納 'OnModelCreating' 中所有值的 SQL 伺服器欄位類型（使用 'HasColumnType'），或用「HasPrecision' 指定精確度與縮放，或使用 'HasConversion' 配置值轉換器。

• 在 PMC 中，輸入下列命令：

  Update-Database
  

  指令 Update-Database 會在未套用的遷移中執行該 Up 方法。 在此情況下，命令會在 Up 檔案中執行 Migrations/<time-stamp>_InitialCreate.cs 方法，以建立資料庫。

Visual Studio 程式碼

• 以滑鼠右鍵按一下 RazorPagesMovie.csproj 專案，然後選取 在整合式終端開啟。

  終端機視窗會在專案目錄中開啟，且命令提示字元位於該目錄；該目錄包含 Program.cs 和 .csproj 檔案。

• 執行下列 .NET CLI 命令：

  dotnet ef migrations add InitialCreate
  

  migrations 命令會產生程式碼來建立初始資料庫結構描述。 結構描述是以 DbContext 中指定的模型為基礎。 InitialCreate 引數用來命名移轉。 你可以使用任何名稱，但依慣例，請選擇描述遷移的名稱。

• 執行下列 .NET CLI 命令：

  dotnet ef database update
  

  指令 update 會在未套用的遷移中執行該 Up 方法。 在此情況下，update 會在 Up 檔案中執行 Migrations/<time-stamp>_InitialCreate.cs 方法，以建立資料庫。

Note

對於 SQLite， Price 欄位類型設為 TEXT。 這個問題會在後續步驟中解決。

資料內容 RazorPagesMovieContext：

• 衍生自 Microsoft.EntityFrameworkCore.DbContext。
• 指定資料模型包含哪些實體。
• 協調EF CoreMovie模型的功能，例如創建、讀取、更新和刪除。

產生檔案的 RazorPagesMovieContext 類別 Data/RazorPagesMovieContext.cs：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; } = default!;
    }
}

上述程式碼會建立實體集的 DbSet<Movie> 屬性。 在 Entity Framework 詞彙中，實體集通常會對應至資料庫資料表。 實體對應到資料表中的資料列。

連接字串的名稱是透過呼叫 DbContextOptions 物件上的方法傳入上下文。 作為本機開發之用，設定系統會從 appsettings.json 檔案讀取連接字串。

測試應用程式

1. 執行應用程式，並將 /Movies 附加至瀏覽器中的 URL (http://localhost:port/movies)。

   如果您收到下列錯誤：

   SqlException: Cannot open database "RazorPagesMovieContext-GUID" requested by the login. The login failed.
   Login failed for user 'User-name'.
   

   您漏掉了遷移步驟。

2. 測試新建連結。

Note

你可能無法在欄位輸入小數逗號 Price 。 若要讓 jQuery 驗證支援使用逗號（","）作為小數點的非英語地區設定，以及非美式英語的日期格式，則必須將應用程式全球化。 如需全球化指示，請參閱此 GitHub 問題 \(英文\)。

1. 測試 Edit、Details 和 Delete 連結。

下一個教學課程說明 Scaffolding 所建立的檔案。

檢查透過相依性插入註冊的內容脈絡

ASP.NET Core 內建相依性插入。 在應用程式啟動時，請以相依注入方式登錄服務，例如資料庫上下文 EF Core 。 透過建構參數提供需要這些服務的元件（例如 Razor 頁面）。 取得資料庫內容執行個體的建構函式程式碼將在本教學課程後面說明。

支架工具會自動建立資料庫上下文，並將其註冊到相依注入容器中。 Scaffolder 會將下列醒目提示的程式碼新增至 Program.cs 檔案：

Visual Studio

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();

app.Run();

Visual Studio 程式碼

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using RazorPagesMovie.Data;
var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages()
   .WithStaticAssets();
   
app.Run();

使用已完成的範例進行疑難排解

若您遇到無法解決的問題，請將您的程式碼與已完成的專案進行比較。 檢視或下載已完成的專案 (如何下載)。

後續步驟

上一步：開始使用下一步：樣板產生的Razor頁面