Note
這不是這篇文章的最新版本。 如需目前發行版本,請參閱本文的 .NET 11 版本。
在本教學課程中,您可以新增類別來管理資料庫中的電影。 這些類別是 "Model" MVC 應用程式的部分。
這些模型類別與 Entity Framework Core(EF Core)一起使用,以處理資料庫。 EF Core 是一個物件關聯映射(ORM)框架,簡化了你必須撰寫的資料存取程式碼。
建立的模型類別稱為 POCO 類別,全名為 Plain Old CLR Objects。 POCO 類別與 EF Core 沒有任何相依性。 它們只會定義資料儲存在資料庫中的屬性。
在本教學課程中,會先建立模型類別,以及 EF Core 建立資料庫。
新增資料模型類別
以滑鼠右鍵按一下 Models 資料夾 >[新增]>[類別]。 將檔案命名為 Movie.cs。
使用下列程式碼更新 Models/Movie.cs 檔案:
using System.ComponentModel.DataAnnotations;
namespace MvcMovie.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 屬性會指定資料的型別 (Date)。 使用此屬性:
- 使用者不需要在日期欄位中輸入時間資訊。
- 只會顯示日期,不會顯示時間資訊。
DataAnnotations 會在後續的教學中介紹。
string 後方的問號表示屬性可為空值。 如需詳細資訊,請參閱可為 Null 的參考型別。
新增 NuGet 套件
Visual Studio 會自動安裝所需的套件。
建置專案以檢查編譯器錯誤。
Scaffold 影片頁面
使用 Scaffolding 工具來為影片模型產生 Create、Read、Update 和 Delete (CRUD) 頁面。
在方案總管,右鍵點擊Controllers資料夾,選擇新增>新鷹架物品。
在 [新增腳手架項目] 對話方塊中:
- 在左窗格中,選取 已安裝>常見>MVC。
- 選取 含檢視的 MVC 控制器,使用 Entity Framework。
- 選取 ,然後新增。
完成 新增具有檢視的 MVC 控制器,使用 Entity Framework 對話方塊:
- 在 [模型類別] 下拉式清單中選取 [影片 (MvcMovie.Models)]。
- 在 資料內容類別 資料列中,選取 +。
- 在 [新增資料內容] 對話方塊中,會產生類別名稱 MvcMovie.Data.MvcMovieCoNtext。
- 選取 ,然後新增。
- 在 Database provider 下拉選單中,選擇 SQL Server。
- 視圖 與 控制器名稱:保留預設值。
- 選取 ,然後新增。
如果您收到錯誤訊息,請選取 [新增] 第二次再試一次。
Scaffolding 會新增下列套件:
Microsoft.EntityFrameworkCore.SqlServerMicrosoft.EntityFrameworkCore.ToolsMicrosoft.VisualStudio.Web.CodeGeneration.Design
Scaffolding 會建立下列內容:
- 電影控制器:
Controllers/MoviesController.cs -
Razor 瀏覽 建立、 刪除、 詳細資料、 編輯及 索引 頁面的檔案:
Views/Movies/*.cshtml - 資料庫內容類別:
Data/MvcMovieContext.cs
Scaffolding 會更新下列項目:
- 在
MvcMovie.csproj專案檔中插入必要的套件參考。 - 在
Program.cs檔案中註冊資料庫內容。 - 在
appsettings.json檔案中新增資料庫連線字串。
自動建立這些檔案和更新檔案的過程稱為 Scaffolding。
模板頁面仍無法使用,因為資料庫不存在。 執行應用程式並選取 [電影應用程式] 連結會導致 無法開啟資料庫 或 沒有這類資料表:Movie 錯誤訊息。
建置應用程式以確認沒有任何錯誤。
初始移轉
使用 EF Core移轉 功能來建立資料庫。 遷移 是一組工具,用來建立並更新資料庫以符合資料模型。
從 Tools 選單中,選擇 NuGet 封裝管理員>封裝管理員 Console 。
在 封裝管理員 Console(PMC)中,輸入以下指令:
Add-Migration InitialCreate
-
Add-Migration InitialCreate: 產生Migrations/{timestamp}_InitialCreate.cs一個遷移檔案。InitialCreate引數是移轉名稱。 您可以使用任何名稱,但依照慣例,會選取描述移轉的名稱。 因為這是第一次移轉,所產生類別會包含建立資料庫結構描述的程式碼。 資料庫結構描述是以MvcMovieContext類別為基礎。
畫面上顯示下列警告,在稍後的步驟中會解決此問題:
實體類型 'Movie' 上的十進位屬性 'Price' 未指定任何存放區類型。 如果它們不符合預設的有效位數和小數位數,將會悄悄截斷這些值。 使用 'HasColumnType' 明確指定可容納 'OnModelCreating' 中所有值的 SQL Server 資料行類型、使用 'HasPrecision' 指定精確度和小數位數,或使用 'HasConversion' 設定值轉換器。
在 PMC 中,輸入下列命令:
Update-Database
-
Update-Database: 更新資料庫至先前指令所建立的最新遷移。 此命令會在Up檔案中執行Migrations/{time-stamp}_InitialCreate.cs方法,以建立資料庫。
欲了解更多關於 EF Core PMC 工具的資訊,請參閱 EF Core 工具參考 - Visual Studio 中的 PMC。
測試應用程式
執行應用程式,然後選取 [電影應用程式] 連結。
如果您收到類似以下的例外狀況,您可能在遷移步驟中錯過了Update-Database 命令:
SqlException: Cannot open database "MvcMovieContext-1" requested by the login. The login failed.
Note
您可能無法在 Price 欄位中輸入小數逗號。 為了在使用逗號 (",") 作為小數點的非英文語系地區和非美式英語日期格式中支援 jQuery 驗證,必須將應用程式全球化。 關於全球化的指示,請參見此GitHub問題。
檢查產生的資料庫上下文類別和註冊
運用 EF Core,使用模型來執行資料存取。 模型是由實體類別和上下文物件所組成,其中上下文物件代表與資料庫的工作階段。 內容物件可讓您查詢和儲存資料。 資料庫上下文源自 Microsoft。EntityFrameworkCore.DbContext 並指定資料模型中要包含的實體。
Scaffolding 會建立 Data/MvcMovieContext.cs 資料庫內容類別:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using MvcMovie.Models;
namespace MvcMovie.Data
{
public class MvcMovieContext : DbContext
{
public MvcMovieContext (DbContextOptions<MvcMovieContext> options)
: base(options)
{
}
public DbSet<MvcMovie.Models.Movie> Movie { get; set; } = default!;
}
}
上述程式碼會建立 DbSet<Movie> 屬性,代表資料庫中的電影。
相依性插入
ASP.NET Core 採用 依賴注入(DI)。 服務,例如資料庫內容,會在 Program.cs 中向 DI 註冊。 這些服務會透過建構函式參數提供給要求它們的元件。
在 Controllers/MoviesController.cs 檔案中,建構函式會使用相依性插入將 MvcMovieContext 資料庫內容插入到控制器中。 控制器中的每一個 CRUD 方法都會使用資料庫內容。
Scaffolding 在 Program.cs 中產生下列已加亮的程式碼:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));
ASP.NET Core 配置系統 讀取「MvcMovieContext」資料庫連接字串。
檢視產生的資料庫連接字串
Scaffolding 為 appsettings.json 文件新增了一個連接字串:
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*",
"ConnectionStrings": {
"MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-4ebefa10-de29-4dea-b2ad-8a8dc6bcf374;Trusted_Connection=True;MultipleActiveResultSets=true"
}
}
在本地開發中,ASP.NET Core 配置系統 會從 ConnectionString 檔案讀取 appsettings.json 金鑰。
InitialCreate 類別
查看 Migrations/{timestamp}_InitialCreate.cs 遷移檔案,
using System;
using Microsoft.EntityFrameworkCore.Migrations;
#nullable disable
namespace MvcMovie.Migrations
{
/// <inheritdoc />
public partial class InitialCreate : Migration
{
/// <inheritdoc />
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.CreateTable(
name: "Movie",
columns: table => new
{
Id = table.Column<int>(type: "int", nullable: false)
.Annotation("SqlServer:Identity", "1, 1"),
Title = table.Column<string>(type: "nvarchar(max)", nullable: true),
ReleaseDate = table.Column<DateTime>(type: "datetime2", nullable: false),
Genre = table.Column<string>(type: "nvarchar(max)", nullable: true),
Price = table.Column<decimal>(type: "decimal(18,2)", nullable: false)
},
constraints: table =>
{
table.PrimaryKey("PK_Movie", x => x.Id);
});
}
/// <inheritdoc />
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DropTable(
name: "Movie");
}
}
}
在上述程式碼中:
-
InitialCreate.Up建立 Movie 表格並設定Id為主鍵。 -
InitialCreate.Down還原遷移時所做的Up結構變更。
控制器中的相依性插入
請開啟 Controllers/MoviesController.cs 檔案並檢查建構函式:
public class MoviesController : Controller
{
private readonly MvcMovieContext _context;
public MoviesController(MvcMovieContext context)
{
_context = context;
}
建構函式會使用相依性插入將資料庫內容 (MvcMovieContext) 插入到控制器中。 控制器中的每一個 CRUD 方法都會使用資料庫內容。
測試 Create 頁面。 輸入並提交資料。
測試 Edit、Details 和 Delete 頁面。
強型別模型和 @model 指示詞
稍早在本教學課程中,您已看到控制器如何使用 ViewData 字典傳遞資料或物件給檢視。
ViewData 字典是一種動態物件,提供靈活的方式以便在後期綁定時將資訊傳遞到視圖。
MVC 提供將強類型模型物件傳遞至視圖的功能。 這種強型別的方法可在編譯時檢查程式碼。 Scaffolding 機制在 MoviesController 類別和視圖中傳遞了強型別模型。
檢查 Details 檔案中所生成的 Controllers/MoviesController.cs 方法:
// GET: Movies/Details/5
public async Task<IActionResult> Details(int? id)
{
if (id == null)
{
return NotFound();
}
var movie = await _context.Movie
.FirstOrDefaultAsync(m => m.Id == id);
if (movie == null)
{
return NotFound();
}
return View(movie);
}
id 參數通常會傳遞為路由資料。 例如,https://localhost:{PORT}/movies/details/1 設定:
- 控制器指向
movies控制器,作為第一個 URL 區段。 - 動作為
details,第二個 URL 區段。 - 如果
id等於 1,則為最後一個 URL 區段。
id 可以使用查詢字串傳入,如下列範例所示:
https://localhost:{PORT}/movies/details?id=1
若未提供 id 值, 參數會定義為可為 null 型別int? (id)。
Lambda 運算式被傳入至 FirstOrDefaultAsync 方法,來選取符合路由資料或查詢字串值的電影實體。
var movie = await _context.Movie
.FirstOrDefaultAsync(m => m.Id == id);
如果電影被找到,則 Movie 模型的執行個體會傳遞至 Details 視圖:
return View(movie);
檢查 Views/Movies/Details.cshtml 檔案的內容:
@model MvcMovie.Models.Movie
@{
ViewData["Title"] = "Details";
}
<h1>Details</h1>
<div>
<h4>Movie</h4>
<hr />
<dl class="row">
<dt class = "col-sm-2">
@Html.DisplayNameFor(model => model.Title)
</dt>
<dd class = "col-sm-10">
@Html.DisplayFor(model => model.Title)
</dd>
<dt class = "col-sm-2">
@Html.DisplayNameFor(model => model.ReleaseDate)
</dt>
<dd class = "col-sm-10">
@Html.DisplayFor(model => model.ReleaseDate)
</dd>
<dt class = "col-sm-2">
@Html.DisplayNameFor(model => model.Genre)
</dt>
<dd class = "col-sm-10">
@Html.DisplayFor(model => model.Genre)
</dd>
<dt class = "col-sm-2">
@Html.DisplayNameFor(model => model.Price)
</dt>
<dd class = "col-sm-10">
@Html.DisplayFor(model => model.Price)
</dd>
</dl>
</div>
<div>
<a asp-action="Edit" asp-route-id="@Model.Id">Edit</a> |
<a asp-action="Index">Back to List</a>
</div>
檢視檔案頂端的 @model 陳述式會指定檢視所預期物件型別。 建立影片控制器時,會包含下列 @model 陳述式:
@model MvcMovie.Models.Movie
此 @model 指令允許存取由控制器傳遞到檢視的影片。
Model 物件為強型別物件。 例如,在 Details.cshtml檢視中,程式碼會使用強型別的 DisplayNameFor 物件,將每個電影欄位傳遞至 DisplayFor 和 Model HTML 協助程式。
Create 與 Edit 方法和檢視也會傳遞 Movie 模型物件。
請檢查 Movies 控制器中的 Index.cshtml 檢視與 Index 方法。 請注意程式碼如何在呼叫 List 方法時建立 View 物件。 此程式碼會從 Movies 動作方法將 Index 清單傳遞至檢視:
// GET: Movies
public async Task<IActionResult> Index()
{
return View(await _context.Movie.ToListAsync());
}
如果資料內容的屬性為空,程式碼會傳回問題詳細資訊。
建立電影控制器時,Scaffolding 會在 @model 檔案的頂端包含下列 Index.cshtml 陳述式:
@model IEnumerable<MvcMovie.Models.Movie>
@model 指令允許使用強型別的 Model 物件,以存取控制器傳遞給檢視的電影清單。 例如,在 Index.cshtml 檢視中,程式碼會使用 foreach 陳述式透過強型別的 Model 物件來循環存取電影:
@model IEnumerable<MvcMovie.Models.Movie>
@{
ViewData["Title"] = "Index";
}
<h1>Index</h1>
<p>
<a asp-action="Create">Create New</a>
</p>
<table class="table">
<thead>
<tr>
<th>
@Html.DisplayNameFor(model => model.Title)
</th>
<th>
@Html.DisplayNameFor(model => model.ReleaseDate)
</th>
<th>
@Html.DisplayNameFor(model => model.Genre)
</th>
<th>
@Html.DisplayNameFor(model => model.Price)
</th>
<th></th>
</tr>
</thead>
<tbody>
@foreach (var item in Model) {
<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>
<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>
因為 Model 物件被強型別為 IEnumerable<Movie> 物件,所以迴圈中每個項目的型別為 Movie。 除了其他優點之外,編譯器會驗證程式碼中使用的型別。