第 2 部分，在 ASP.NET Core 中向 Razor 页面应用添加模型

在本教程中，将添加用于管理数据库中电影的类。 应用程序的模型类使用 Entity Framework Core (EF Core) 来处理数据库。 EF Core 是一种对象关系映射器 (O/RM)，可简化数据访问。 首先要编写模型类，然后 EF Core 将创建数据库。

这些模型类被称为 POCO 类（源自“Plain-Old CLR Objects”），因为它们不依赖于 EF Core。 它们定义数据库中存储的数据属性。

添加数据模型

Visualstudio

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 Code

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 核心运行时环境。

Note

默认情况下，要安装的.NET二进制文件的体系结构表示当前运行的操作系统体系结构。 若要指定其他架构，请参阅如何使用 dotnet tool install 命令并配合 '--arch' 选项。 有关详细信息，请参阅 GitHub dotnet/aspnetcore.docs 议题 #29262 - 在 Apple Silicon 上添加“-a arm64”。

在 Visual Studio Code 中，按 Ctrl +F5 运行应用而不进行调试。

在编辑器区域下面的 面板中 ，选择 “问题 ”选项卡，或者从 “视图 ”菜单中选择 “问题 ”（如果当前不在视图中）。 验证没有编译错误。

搭建“电影”模型的基架

在本部分中，你将搭建电影模型基架。 脚手架工具为电影模型生成用于创建、读取、更新和删除（CRUD）操作的页面。

Visualstudio

1. 创建“Pages/Movies”文件夹：

   1. 右键单击Pages文件夹，然后选择>添加>新建文件夹。
   2. 将文件夹命名为“Movies”。

2. 右键单击 Pages/Movies 文件夹 >添加>新建基架项。

1. 在“添加新脚手架”对话框中，选择Razor“使用 Entity Framework 的页面 (CRUD)”>，然后单击“添加”。

1. 完成“使用 Entity Framework 添加Razor页面 (CRUD)”对话框：

   1. 在模型类下拉列表中，选择Movie (RazorPagesMovie.Models)。
   2. 在“数据上下文类”行中，选择 +（加号）。
      1. 在“添加数据上下文”对话框中，生成类名 。
      2. 在“数据库提供程序”下拉列表中，选择“SQL Server”。
   3. 选择 并添加。

   

appsettings.json 文件通过用于连接到本地数据的连接字符串进行更新。

Visual Studio Code

• 打开项目目录（包含 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 添加到“编辑”和“创建”页面

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

下一教程介绍了已创建的文件。

基架进程将以下突出显示的代码添加到 Program.cs 文件中：

Visualstudio

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 Code

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 中的迁移功能提供了一种方法来执行以下操作：

• 创建初始数据库架构。
• 以增量的方式更新数据库架构，使其与应用的数据模型保持同步。 此方法保留数据库中的现有数据。

Visualstudio

在本部分中，使用 包管理器控制台 （PMC）窗口执行以下作：

• 添加初始迁移。

• 使用初始迁移来更新数据库。

• 在“工具”菜单中，选择“NuGet 包管理器”“包管理器控制台”。

  

• 在 PMC 中，输入以下命令：

  Add-Migration InitialCreate
  

• Add-Migration 命令生成用于创建初始数据库架构的代码。 该架构基于在 DbContext 中指定的模型。 参数 InitialCreate 命名迁移。 可以使用任何名称，但按照约定选择描述迁移的名称。

将显示以下警告，可在后续步骤中解决该警告：

实体类型“Movie”上没有为小数列“Price”指定存储类型。 如果值不符合默认精度和比例，则会导致值被无提示或警告地截断。 使用“HasColumnType”显式指定可以容纳“OnModelCreating”中的所有值的 SQL Server 列类型，使用“HasPrecision”指定精度和缩放，或使用“HasConversion”配置值转换器。

• 在 PMC 中，输入以下命令：

  Update-Database
  

  未应用的迁移中，Update-Database 命令运行 Up 方法。 在这种情况下，命令在用于创建数据库的 Up 文件中运行 Migrations/<time-stamp>_InitialCreate.cs 方法。

Visual Studio Code

• 右键单击“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 Core 模型的“创建”、“读取”、“更新”和“ Movie 删除”等功能。

生成的文件 Data/RazorPagesMovieContext.cs 中的 RazorPagesMovieContext 类：

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> 属性。 在实体框架术语中，实体集通常与数据表相对应。 一个实体对应于表中的一行。

连接字符串的名称通过对 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. 测试“编辑”、“详细信息”和“删除”链接。

下一个教程将讲解通过脚手架生成的文件。

检查通过依赖注入注册的上下文

ASP.NET Core 通过依赖关系注入进行生成。 在应用程序启动期间，使用依赖注入注册服务，例如 EF Core 数据库上下文。 通过构造函数参数提供需要这些服务（如 Razor Pages）的组件。 本教程的后续部分介绍了用于获取数据库上下文实例的构造函数代码。

基架工具会自动创建数据库上下文并将其注册到依赖项注入容器。 脚手架工具将以下高亮显示的代码添加到 Program.cs 文件中：

Visualstudio

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 Code

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