在 ASP.NET Core 中向 Razor Pages 应用添加模型
在本节中,添加了用于管理数据库中的电影的类。 这些类与 Entity Framework Core(EF Core)一起使用来处理数据库。 EF Core 是一种对象关系映射 (ORM) 框架,可以简化数据访问代码。
模型类称为 POCO 类(源自“简单传统 CLR 对象”),因为它们与 EF Core 没有任何依赖关系。 它们定义数据库中存储的数据属性。
查看或下载示例。
添加数据模型
右键单击“RazorPagesMovie”项目 >“添加” > “新建文件夹”。 将文件夹命名为“Models”。
右键单击“Models”文件夹。 选择“添加” > “类”。 将类命名“Movie”。
向 Movie
类添加以下属性:
using System;
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(DataType.Date)]
:DataType 属性指定数据的类型(日期)。 通过此特性:- 用户无需在数据字段中输入时间信息。
- 仅显示日期,而非时间信息。
DataAnnotations 会在后续教程中介绍。
生成项目以验证没有任何编译错误。
搭建“电影”模型的基架
在此部分,将搭建“电影”模型的基架。 确切地说,基架工具将生成页面,用于对“电影”模型执行创建、读取、更新和删除 (CRUD) 操作。
创建“Pages/Movies”文件夹:
- 右键单击 Pages 文件夹 >“添加” > “新建文件夹”。
- 将文件夹命名为“Movies”
右键单击 Pages/Movies 文件夹 >“添加” > “新搭建基架的项目”。
在“添加基架”对话框中,选择“使用实体框架生成 Razor Pages (CRUD)” > “添加”。
完成“使用实体框架(CRUD)添加 Razor Pages”对话框:
- 在“模型类”下拉列表中,选择“Movie (RazorPagesMovie.Models)。
- 在“数据上下文类”行中,选择 +(加号)并接受生成的名称“RazorPagesMovie.Models.RazorPagesMovieContext”。
- 选择“添加”。
appsettings.json 文件通过用于连接到本地数据的连接字符串进行更新。
在搭建基架时,会创建并更新以下文件:
创建的文件
- Pages/Movies:“创建”、“删除”、“详细信息”、“编辑”和“索引”。
- Data/RazorPagesMovieContext.cs
文件已更新
- Startup.cs
创建和更新的文件将在下一节中说明。
初始迁移
在此部分中,程序包管理器控制台 (PMC) 用于:
- 添加初始迁移。
- 使用初始迁移来更新数据库。
从“工具”菜单中,选择“NuGet 包管理器” > “包管理器控制台”。
在 PMC 中,输入以下命令:
Add-Migration Initial
Update-Database
前面的命令生成以下警告:“No type was specified for the decimal column 'Price' on entity type 'Movie'. This will cause values to be silently truncated if they do not fit in the default precision and scale. Explicitly specify the SQL server column type that can accommodate all the values using 'HasColumnType()'.”
你可以忽略该警告,它将后面的教程中得到修复。
ef migrations add InitialCreate 命令生成用于创建初始数据库架构的代码。 此架构的依据为 DbContext 中指定的模型(在 RazorPagesMovieContext.cs 文件中)。 InitialCreate 参数用于为迁移命名。 可以使用任何名称,但是按照惯例,会选择可说明迁移的名称。
ef database update 命令在 Migrations/<time-stamp>_InitialCreate.cs 文件中运行 Up 方法。 Up方法会创建数据库。
检查通过依赖关系注入注册的上下文
ASP.NET Core 通过依赖关系注入进行生成。 服务(例如 EF Core 数据库上下文)在应用程序启动期间通过依赖关系注入进行注册。 需要这些服务(如 Razor 页面)的组件通过构造函数提供相应服务。 本教程的后续部分介绍了用于获取 DB 上下文实例的构造函数代码。
基架工具自动创建 DB 上下文并将其注册到依赖关系注入容器。
检查 Startup.ConfigureServices
方法。 基架添加了突出显示的行:
// This method gets called by the runtime.
// Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
services.Configure<CookiePolicyOptions>(options =>
{
// This lambda determines whether user consent for non-essential cookies is
// needed for a given request.
options.CheckConsentNeeded = context => true;
options.MinimumSameSitePolicy = SameSiteMode.None;
});
services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
services.AddDbContext<RazorPagesMovieContext>(options =>
options.UseSqlServer(
Configuration.GetConnectionString("RazorPagesMovieContext")));
}
RazorPagesMovieContext
为 Movie
模型协调 EF Core 功能(创建、读取、更新、删除等)。 数据上下文 (RazorPagesMovieContext
) 派生自 Microsoft.EntityFrameworkCore.DbContext。 数据上下文指定数据模型中包含哪些实体。
using Microsoft.EntityFrameworkCore;
namespace RazorPagesMovie.Models
{
public class RazorPagesMovieContext : DbContext
{
public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options)
: base(options)
{
}
public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
}
}
前面的代码为实体集创建 DbSet<Movie>
属性。 在实体框架术语中,实体集通常与数据表相对应。 实体对应表中的行。
通过调用 DbContextOptions 对象中的一个方法将连接字符串名称传递到上下文。 进行本地开发时, ASP.NET Core 配置系统 在 appsettings.json 文件中读取数据库连接字符串。
Add-Migration 命令生成用于创建初始数据库架构的代码。 此架构的依据为 RazorPagesMovieContext中指定的模型(在 Data/RazorPagesMovieContext.cs 文件中)。 Initial 参数用于为迁移命名。 可以使用任何名称,但是按照惯例,会使用可说明迁移的名称。 有关更多信息,请参见教程:使用迁移功能 - ASP.NET MVC 和 EF Core。
Update-Database 命令在用于创建数据库的 Migrations/{time-stamp}_InitialCreate.cs 文件中运行 Up方法。
测试应用
- 运行应用并将 /Movies 追加到浏览器中的 URL (http://localhost:port/movies)。
如果收到错误:
console
SqlException: Cannot open database "RazorPagesMovieContext-GUID" requested by the login. The login failed.
Login failed for user 'User-name'.
缺少迁移步骤。
- 测试“创建”链接。
备注可能无法在 Price 字段中输入十进制逗号。 若要使 jQuery 验证支持使用逗号(“,”)表示小数点的非英语区域设置,以及支持非美国英语日期格式,应用必须进行全球化。 有关全球化的说明,请参阅
此 GitHub 问题。- 测试“编辑”、“详细信息”和“删除”链接。
更多建议: