1、前言

本文开始介绍一些关于Entity Framework Core的内容。在EFCore中，常用的为DB First模式和Code First模式，下面就来介绍一下如何在EFCore中使用DB First模式生成实体类和数据库上下文。

2、创建测试数据库

在SQL Server中新建一个数据库Dao，执行如下语句，创建Country和Province数据表。

USE [Dao]
GO/****** Object:  Table [dbo].[Country]    Script Date: 2022/11/30 8:52:23 ******/
SET ANSI_NULLS ON
GOSET QUOTED_IDENTIFIER ON
GOCREATE TABLE [dbo].[Country]([Id] [int] IDENTITY(1,1) NOT NULL,[CountryName] [nvarchar](20) NULL,CONSTRAINT [PK_Country] PRIMARY KEY CLUSTERED 
([Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY]
GO

USE [Dao]
GO/****** Object:  Table [dbo].[Province]    Script Date: 2022/11/30 8:53:00 ******/
SET ANSI_NULLS ON
GOSET QUOTED_IDENTIFIER ON
GOCREATE TABLE [dbo].[Province]([Id] [int] IDENTITY(1,1) NOT NULL,[ProvinceName] [nvarchar](20) NULL,CONSTRAINT [PK_Province] PRIMARY KEY CLUSTERED 
([Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY]
GO

运行结果如下图所示：

3、引入EFCore相关组件

创建一个Web API项目，使用NuGet引入如下四个组件，这里全部选择3.1.31版本：

Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer
Microsoft.EntityFrameworkCore.Design
Microsoft.EntityFrameworkCore.Tools

4、生成实体类和数据库上下文

在EFCore中，使用DB First模式生成实体类和数据库上下文时需要使用Scaffold-DbContext命令，该命令的格式如下所示：

Scaffold-DbContext [-Connection]  [-Provider]  [-OutputDir ] [-ContextDir ] [-Context ] [-Schemas ] [-Tables ] [-DataAnnotations] [-UseDatabaseNames] [-Force] [-Project ] [-StartupProject ][]

Scaffold-DbContext命令中的参数说明如下表所示：

打开NuGet控制台，输入如下命令：

Scaffold-DbContext -Connection "Data Source=DSF-PC;Initial Catalog=Dao;User ID=sa;Password=123456;" -Provider Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Context -Context DaoDbContext

运行结果如下图所示，可以发现已经创建了实体类Country、Province和数据库上下文类DaoDbContext。到此为止，我们已经可以通过Scaffold-DbContext命令生成实体类和数据库上下文了。

5、Scaffold-DbContext命令中一些参数的含义及作用

在上面的代码中，我们对Scaffold-DbContext命令中的一些关键参数进行了设置：

• -OutputDir Models：存放实体类的文件夹名称为Models
• -ContextDir Context：存放数据库上下文的文件夹名称为Context
• -Context DaoDbContext：数据库上下文的名称为DaoDbContext

其实Scaffold-DbContext命令中还包括一些很有用的其他参数，下面举例说明。

5.1、只对数据库中的某些表生成实体类该怎么做？

在某些情况下，我们并不希望数据库中所有的表都生成实体类，而是只将某些需要的表生成实体类即可，此时就需要对-Tables参数进行设置，下面的代码只对Country表生成实体类，而Province表则不生成实体类。

Scaffold-DbContext -Connection "Data Source=DSF-PC;Initial Catalog=Dao;User ID=sa;Password=123456;" -Provider Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Context -Context DaoDbContext -Tables "Country"

5.2、如何生成实体类字段的数据注解？

当前的实体类字段并不包含数据注解，如下图所示：

如果需要生成数据注解，只需要添加一个-DataAnnotations参数即可，代码如下：

Scaffold-DbContext -Connection "Data Source=DSF-PC;Initial Catalog=Dao;User ID=sa;Password=123456;" -Provider Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Context -Context DaoDbContext -DataAnnotations

可以发现实体类字段已经生成了对应的数据注解。

5.3、数据库被修改后如何更新实体类和数据库上下文？

当前工程中的实体类和数据库上下文如下图所示：

下面对数据库进行一些修改。首先在Dao数据库中新增一张City表，代码如下：

USE [Dao]
GO/****** Object:  Table [dbo].[City]    Script Date: 2022/11/30 9:30:54 ******/
SET ANSI_NULLS ON
GOSET QUOTED_IDENTIFIER ON
GOCREATE TABLE [dbo].[City]([Id] [int] IDENTITY(1,1) NOT NULL,[CityName] [nvarchar](20) NULL,[CreateTime] [datetime] NULL,CONSTRAINT [PK_City] PRIMARY KEY CLUSTERED 
([Id] ASC
)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
) ON [PRIMARY]
GO

然后在Country表和Province表中新增一个字段CreateTime，代码如下：

alter table Country add [CreateTime] datetime null
alter table Province add [CreateTime] datetime null

现在对数据库的修改已经完成，下面就需要对实体类和数据库上下文进行更新了，我们只需要在Scaffold-DbContext命令后面加上-Force参数即可，它可以帮助我们重新生成实体类和数据库上下文并覆盖原有文件。

Scaffold-DbContext -Connection "Data Source=DSF-PC;Initial Catalog=Dao;User ID=sa;Password=123456;" -Provider Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Context -Context DaoDbContext -DataAnnotations -Force

可以发现覆盖后的文件已经新增了City实体类，Country和Province实体类也都新增了CreateTime字段。

5.4、分层项目中如何在其他类库中生成实体类和数据库上下文？

在实际开发过程中，很多项目都会进行分层操作，例如新建一个App.Models类库用来存放实体类和数据库上下文，如下图所示：

如果想在App.Models类库中生成实体类和数据库上下文也很简单，只需要按照如下步骤操作即可，首先在App.Models中使用NuGet引入EFCore的相关组件，如下所示：

Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer
Microsoft.EntityFrameworkCore.Design
Microsoft.EntityFrameworkCore.Tools

然后生成一下解决方案：

最后在Scaffold-DbContext命令中设置-Project和-StartupProject参数，代码如下：

Scaffold-DbContext -Connection "Data Source=DSF-PC;Initial Catalog=Dao;User ID=sa;Password=123456;" -Provider Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -ContextDir Context -Context DaoDbContext -DataAnnotations -Force -Project App.Models -StartupProject App.Models

可以发现在App.Models项目中已经生成了实体类和数据库上下文。

6、注入数据库上下文

现在实体类和数据库上下文都有了，接下来只需要在Controller中将其注入即可。首先在appsettings.json文件中配置数据库连接字符串，代码如下：

{"Logging": {"LogLevel": {"Default": "Information","Microsoft": "Warning","Microsoft.Hosting.Lifetime": "Information"}},"AllowedHosts": "*","ConnectionStrings": {"ConnectionString": "Data Source=DSF-PC;Initial Catalog=Dao;User ID=sa;Password=123456;"}
}

然后在Startup.cs文件中添加数据库上下文，代码如下所示：

using App.Context;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;namespace App
{public class Startup{public Startup(IConfiguration configuration){Configuration = configuration;}public IConfiguration Configuration { get; }// This method gets called by the runtime. Use this method to add services to the container.public void ConfigureServices(IServiceCollection services){// 添加控制器services.AddControllers();// 添加数据库上下文services.AddDbContext(options =>{options.UseSqlServer(Configuration.GetConnectionString("ConnectionString"));});}// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.public void Configure(IApplicationBuilder app, IWebHostEnvironment env){if (env.IsDevelopment()){app.UseDeveloperExceptionPage();}app.UseHttpsRedirection();app.UseRouting();app.UseAuthorization();app.UseEndpoints(endpoints =>{endpoints.MapControllers();});}}
}

最后新建一个控制器CountryController.cs，将DaoDbContext注入即可，代码如下：

using App.Context;
using App.Models;
using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
using System.Linq;namespace App.Controllers
{[Route("api/[controller]/[action]")][ApiController]public class CountryController : ControllerBase{protected readonly DaoDbContext _dbContext;/// 
/// 构造函数/// 
/// public CountryController(DaoDbContext dbContext){_dbContext = dbContext;}/// 
/// 添加实体集合/// 
/// [HttpGet]public ActionResult Add(){List list = new List{new Country { CountryName = "中国" },new Country { CountryName = "美国" },new Country { CountryName = "俄罗斯" }};_dbContext.Set().AddRange(list);_dbContext.SaveChanges();return "添加实体成功";}/// 
/// 获取实体集合/// 
/// [HttpGet]public ActionResult> Get(){return _dbContext.Set().ToList();}}
}

执行Add方法后，运行结果如下图所示：

执行Get方法后，运行结果如下图所示：

7、结语

本文主要介绍了一些关于EFCore中DB First开发模式的内容，对于Scaffold-DbContext命令中其他的参数含义及作用，有兴趣的同志也可以自行深入研究。如果你参与的项目之前就已经存在数据库，那么选用DB First模式可能会更加方便友好。