ASP.NET Core 中的 Razor 页面和 EF Core - CRUD
Contoso University Web 应用演示了如何使用 EF Core 和 Visual Studio 创建 Razor 页面 Web 应用。若要了解系列教程，请参阅第一个教程。
本教程将介绍和自定义已搭建基架的 CRUD （创建、读取、更新、删除）代码。
为最大程度降低复杂性并让这些教程集中介绍 EF Core，将在页面模型中使用 EF Core 代码。 某些开发人员使用服务层或存储库模式在 UI（Razor 页面）和数据访问层之间创建抽象层。
本教程将检查“学生”文件夹中的“创建”、“编辑”、“删除”和“详细信息”Razor Pages。
基架代码将以下模式用于“创建”、“编辑”和“删除”页面：
- 使用 HTTP GET 方法 OnGetAsync 获取和显示请求数据。
- 使用 HTTP POST 方法 OnPostAsync 将更改保存到数据。
“索引”和“详细信息”页面使用 HTTP GET 方法 OnGetAsync 获取和显示请求数据
SingleOrDefaultAsync 与FirstOrDefaultAsync
生成的代码使用 FirstOrDefaultAsync其推荐度通常高于 SingleOrDefaultAsync。
提取一个实体时，使用 FirstOrDefaultAsync 比使用 SingleOrDefaultAsync 更高效：
- 代码需要验证查询仅返回一个实体时除外。
- SingleOrDefaultAsync 会提取更多数据并执行不必要的工作。
- 如果有多个实体符合筛选部分，SingleOrDefaultAsync 将引发异常。
- 如果有多个实体符合筛选部分，FirstOrDefaultAsync 不引发异常。
FindAsync
在大部分基架代码中，FindAsync 可用于替代 FirstOrDefaultAsync。
FindAsync：
- 查找具有主键 (PK) 的实体。 如果具有 PK 的实体正在由上下文跟踪，会返回该实体且不向 DB 发出请求。
- 既简单又简洁。
- 经过优化后可查找单个实体。
- 在某些情况下可以提供性能优势，但很少发生在典型的 Web 应用中。
- 以隐式方式使用 FirstAsync 而不是 SingleAsync。
如果想要 Include 其他实体，则 FindAsync 将不再适用。 这意味着可能需要放弃 FindAsync 并随着应用运行移动到查询。
自定义“详细信息”页
浏览到 Pages/Students 页面。 “编辑”、“详细信息”和“删除”链接是在 Pages/Students/Index.cshtml 文件中由定位点标记帮助器生成的。
CSHTML
<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>
运行应用并选择“详细信息”链接。 URL 的格式为 http://localhost:5000/Students/Details?id=2。 “学生 ID”通过查询字符串 (?id=2) 进行传递。
更新“编辑”、“详细信息”和“删除”Razor 页面以使用 "{id:int}" 路由模板。 将上述每个页面的页面指令从 @page 更改为 @page "{id:int}"。
如果对具有不包含整数路由值的“{id:int}”路由模板的页面发起请求，则该请求将返回 HTTP 404（找不到）错误。 例如，http://localhost:5000/Students/Details 返回 404 错误。 若要使 ID 可选，请将 ? 追加到路由约束：
CSHTML
@page "{id:int?}"
运行应用，单击“详细信息”链接，并验证确认 URL 正在将 ID 作为路由数据 (http://localhost:5000/Students/Details/2) 进行传递。
不要将 @page 全局更改为 @page "{id:int}"，执行此操作会将链接拆分为“主页”和“创建”页。
添加相关数据
“学生索引”页的基架代码不包括 Enrollments 属性。 在本部分，Enrollments 集合的内容显示在“详细信息”页中。
Pages/Students/Details.cshtml.cs 的 OnGetAsync 方法使用 FirstOrDefaultAsync 方法检索单个 Student 实体。 添加以下突出显示的代码：
C#
public async Task<IActionResult> OnGetAsync(int? id)
{
if (id == null)
{
return NotFound();
}
Student = await _context.Student
.Include(s => s.Enrollments)
.ThenInclude(e => e.Course)
.AsNoTracking()
.FirstOrDefaultAsync(m => m.ID == id);
if (Student == null)
{
return NotFound();
}
return Page();
}
Include 和 ThenInclude 方法使上下文加载 Student.Enrollments 导航属性，并在每个注册中加载 Enrollment.Course 导航属性。 这些方法将在与数据读取相关的教程中进行详细介绍。
对于返回的实体未在当前上下文中更新的情况，AsNoTracking 方法将会提升性能。 AsNoTracking 将在本教程的后续部分中讨论。
在“详细信息”页中显示相关注册
打开 Pages/Students/Details.cshtml。 添加以下突出显示的代码以显示注册列表：
CSHTML
@page "{id:int}"
@model ContosoUniversity.Pages.Students.DetailsModel
@{
ViewData["Title"] = "Details";
}
<h2>Details</h2>
<div>
<h4>Student</h4>
<hr />
<dl class="dl-horizontal">
<dt>
@Html.DisplayNameFor(model => model.Student.LastName)
</dt>
<dd>
@Html.DisplayFor(model => model.Student.LastName)
</dd>
<dt>
@Html.DisplayNameFor(model => model.Student.FirstMidName)
</dt>
<dd>
@Html.DisplayFor(model => model.Student.FirstMidName)
</dd>
<dt>
@Html.DisplayNameFor(model => model.Student.EnrollmentDate)
</dt>
<dd>
@Html.DisplayFor(model => model.Student.EnrollmentDate)
</dd>
<dt>
@Html.DisplayNameFor(model => model.Student.Enrollments)
</dt>
<dd>
<table class="table">
<tr>
<th>Course Title</th>
<th>Grade</th>
</tr>
@foreach (var item in Model.Student.Enrollments)
{
<tr>
<td>
@Html.DisplayFor(modelItem => item.Course.Title)
</td>
<td>
@Html.DisplayFor(modelItem => item.Grade)
</td>
</tr>
}
</table>
</dd>
</dl>
</div>
<div>
<a asp-page="./Edit" asp-route-id="@Model.Student.ID">Edit</a> |
<a asp-page="./Index">Back to List</a>
</div>
如果代码缩进在粘贴代码后出现错误，请按 CTRL-K-D 进行更正。
上面的代码循环通过 Enrollments 导航属性中的实体。 它将针对每个注册显示课程标题和成绩。 课程标题从 Course 实体中检索，该实体存储在 Enrollments 实体的 Course 导航属性中。
运行应用，选择“学生”选项卡，然后单击学生的“详细信息”链接。 随即显示出所选学生的课程和成绩列表。
更新“创建”页
将 Pages/Students/Create.cshtml.cs 中的 OnPostAsync 方法更新为以下代码：
C#
public async Task<IActionResult> OnPostAsync()
{
if (!ModelState.IsValid)
{
return Page();
}
var emptyStudent = new Student();
if (await TryUpdateModelAsync<Student>(
emptyStudent,
"student", // Prefix for form value.
s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate))
{
_context.Student.Add(emptyStudent);
await _context.SaveChangesAsync();
return RedirectToPage("./Index");
}
return null;
}
TryUpdateModelAsync
检查 TryUpdateModelAsync 代码：
C#
var emptyStudent = new Student();
if (await TryUpdateModelAsync<Student>(
emptyStudent,
"student", // Prefix for form value.
s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate))
{
在前面的代码中，TryUpdateModelAsync<Student> 尝试使用 PageModel 的 PageContext 属性中已发布的表单值更新 emptyStudent 对象。 TryUpdateModelAsync 仅更新列出的属性 (s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate)。
在上述示例中：
- 第二个自变量 ("student", // Prefix) 是用于查找值的前缀。 该自变量不区分大小写。
- 已发布的表单值通过模型绑定转换为 Student 模型中的类型。
过多发布
使用 TryUpdateModel 更新具有已发布值的字段是一种最佳的安全做法，因为这能阻止过多发布。 例如，假设 Student 实体包含此网页不应更新或添加的 Secret 属性：
C#
public class Student
{
public int ID { get; set; }
public string LastName { get; set; }
public string FirstMidName { get; set; }
public DateTime EnrollmentDate { get; set; }
public string Secret { get; set; }
}
即使应用的创建/更新 Razor 页面上没有 Secret 字段，黑客仍可利用过多发布设置 Secret 值。 黑客也可使用 Fiddler 等工具或通过编写某个 JavaScript 来发布 Secret 表单值。 原始代码不会限制模型绑定器在创建“学生”实例时使用的字段。
黑客为 Secret 表单字段指定的任何值都会在 DB 中更新。 下图显示 Fiddler 工具正在将 Secret 字段（值为“OverPost”）添加到已发布的表单值。
值“OverPost”已成功添加到所插入行的 Secret 属性中。 应用程序设计器绝不会在“创建”页设置 Secret 属性。
视图模型
视图模型通常包含应用程序所用的模型中包括的属性的子集。 应用程序模型通常称为域模型。 域模型通常包含 DB 中对应实体所需的全部属性。 视图模型仅包含 UI 层（例如“创建”页）所需的属性。除视图模型外，某些应用使用绑定模型或输入模型在“Razor 页面”页面模型类和浏览器之间传递数据。 请考虑以下 Student 视图模型：
C#
using System;
namespace ContosoUniversity.Models
{
public class StudentVM
{
public int ID { get; set; }
public string LastName { get; set; }
public string FirstMidName { get; set; }
public DateTime EnrollmentDate { get; set; }
}
}
视图模型还提供了一种防止过度发布的方法。 视图模型仅包含要查看（显示）或更新的属性。
以下代码使用 StudentVM 视图模型创建新的学生：
C#
[BindProperty]
public StudentVM StudentVM { get; set; }
public async Task<IActionResult> OnPostAsync()
{
if (!ModelState.IsValid)
{
return Page();
}
var entry = _context.Add(new Student());
entry.CurrentValues.SetValues(StudentVM);
await _context.SaveChangesAsync();
return RedirectToPage("./Index");
}
SetValues 方法通过从另一个 PropertyValues 对象读取值来设置此对象的值。 SetValues 使用属性名称匹配。 视图模型类型不需要与模型类型相关，它只需要具有匹配的属性。
使用 StudentVM 时需要更新 CreateVM.cshtml 才能使用 StudentVM 而非 Student。
在 Razor 页面，PageModel 派生类就是视图模型。
更新“编辑”页
更新“编辑”页的页面模型。 突出显示所作的主要更改：
C#
public class EditModel : PageModel
{
private readonly SchoolContext _context;
public EditModel(SchoolContext context)
{
_context = context;
}
[BindProperty]
public Student Student { get; set; }
public async Task<IActionResult> OnGetAsync(int? id)
{
if (id == null)
{
return NotFound();
}
Student = await _context.Student.FindAsync(id);
if (Student == null)
{
return NotFound();
}
return Page();
}
public async Task<IActionResult> OnPostAsync(int? id)
{
if (!ModelState.IsValid)
{
return Page();
}
var studentToUpdate = await _context.Student.FindAsync(id);
if (await TryUpdateModelAsync<Student>(
studentToUpdate,
"student",
s => s.FirstMidName, s => s.LastName, s => s.EnrollmentDate))
{
await _context.SaveChangesAsync();
return RedirectToPage("./Index");
}
return Page();
}
}
代码更改与“创建”页类似，但有少数例外：
- OnPostAsync 具有可选的 id 参数。
- 当前学生是从 DB 提取的，而非通过创建空学生获得。
- 已将 FirstOrDefaultAsync 替换为 FindAsync。 从主键中选择实体时，使用 FindAsync 是一个不错的选择。 请参阅 FindAsync 了解详细信息。
测试“编辑”和“创建”页
创建和编辑几个学生实体。
实体状态
DB 上下文会随时跟踪内存中的实体是否已与其在 DB 中的对应行进行同步。 DB 上下文同步信息可决定调用 SaveChangesAsync 后的行为。 例如，将新实体传递到 AddAsync 方法时，该实体的状态设置为 Added。 调用 SaveChangesAsync 时，DB 上下文会发出 SQL INSERT 命令。
实体可能处于以下状态之一：
- Added：DB 中尚不存在实体。 SaveChanges 方法发出 INSERT 语句。
- Unchanged：无需保存对该实体所做的任何更改。 从 DB 中读取实体时，该实体将具有此状态。
- Modified：已修改实体的部分或全部属性值。 SaveChanges 方法发出 UPDATE 语句。
- Deleted：已标记该实体进行删除。 SaveChanges 方法发出 DELETE 语句。
- Detached：DB 上下文未跟踪该实体。
在桌面应用中，通常会自动设置状态更改。 读取实体并执行更改后，实体状态自动更改为 Modified。 调用 SaveChanges 会生成仅更新已更改属性的 SQL UPDATE 语句。
在 Web 应用中，读取实体并显示数据的 DbContext 将在页面呈现后进行处理。 调用页面 OnPostAsync 方法时，将发出具有 DbContext 的新实例的 Web 请求。 如果在这个新的上下文中重新读取实体，则会模拟桌面处理。
更新“删除”页
在此部分中，当对 SaveChanges 的调用失败时，将添加用于实现自定义错误消息的代码。 添加字符串，使其包含可能的错误消息：
C#
public class DeleteModel : PageModel
{
private readonly SchoolContext _context;
public DeleteModel(SchoolContext context)
{
_context = context;
}
[BindProperty]
public Student Student { get; set; }
public string ErrorMessage { get; set; }
将 OnGetAsync 方法替换为以下代码：
C#
public async Task<IActionResult> OnGetAsync(int? id, bool? saveChangesError = false)
{
if (id == null)
{
return NotFound();
}
Student = await _context.Student
.AsNoTracking()
.FirstOrDefaultAsync(m => m.ID == id);
if (Student == null)
{
return NotFound();
}
if (saveChangesError.GetValueOrDefault())
{
ErrorMessage = "Delete failed. Try again";
}
return Page();
}
上述代码包含可选参数 saveChangesError。 saveChangesError 指示学生对象删除失败后是否调用该方法。 删除操作可能由于暂时性网络问题而失败。 云端更可能出现暂时性网络错误。 通过 UI 调用“删除”页 OnGetAsync 时，saveChangesError 为 false。 当 OnPostAsync 调用 OnGetAsync（由于删除操作失败）时，saveChangesError 参数为 true。
“删除”页 OnPostAsync 方法
将 OnPostAsync 替换为以下代码：
C#
public async Task<IActionResult> OnPostAsync(int? id)
{
if (id == null)
{
return NotFound();
}
var student = await _context.Student
.AsNoTracking()
.FirstOrDefaultAsync(m => m.ID == id);
if (student == null)
{
return NotFound();
}
try
{
_context.Student.Remove(student);
await _context.SaveChangesAsync();
return RedirectToPage("./Index");
}
catch (DbUpdateException /* ex */)
{
//Log the error (uncomment ex variable name and write a log.)
return RedirectToAction("./Delete",
new { id, saveChangesError = true });
}
}
上述代码检索所选的实体，然后调用 Remove 方法，将实体的状态设置为 Deleted。 调用 SaveChanges 时生成 SQL DELETE 命令。 如果 Remove 失败：
- 会捕获 DB 异常。
- 通过 saveChangesError=true 调用“删除”页 OnGetAsync 方法。
更新“删除”Razor 页面
将以下突出显示的错误消息添加到“删除”Razor 页面。
CSHTML
@page "{id:int}"
@model ContosoUniversity.Pages.Students.DeleteModel
@{
ViewData["Title"] = "Delete";
}
<h2>Delete</h2>
<p class="text-danger">@Model.ErrorMessage</p>
<h3>Are you sure you want to delete this?</h3>
<div>
测试“删除”。
常见错误
“学生/索引”或其他链接不起作用：
验证确认 Razor 页面包含正确的 @page 指令。 例如，“学生/索引”Razor Pages 不得包含路由模板：
CSHTML
@page "{id:int}"
每个 Razor 页面均必须包含 @page 指令。
更多建议：