ASP.NET Core 入门教程 8、ASP.NET Core + Entity Framework Core 数据访问入门

一、前言

1、本教程主要内容

• ASP.NET Core MVC 集成 EF Core 介绍&操作步骤
• ASP.NET Core MVC 使用 EF Core + Linq to Entity 访问MySQL数据库
• ASP.NET Core MVC 使用 EF Core + 原生SQL访问MySql数据库
• EF Core + MySQL数据库插入数据后获取自增列的值

Entity Framework Core 简称为 EF Core

2、本教程环境信息

软件/环境	说明
操作系统	Windows 10
SDK	2.1.401
ASP.NET Core	2.1.3
MySQL	8.0.x
IDE	Visual Studio Code 1.30
浏览器	Chrome 70

VS Code插件	版本	说明
C#	1.17.1	提供C#智能感知， .NET Core 调试、编译等
vscdoe-solution-explorer	0.3.1	提供解决方案视图

本篇代码以下代码进行调整：https://github.com/ken-io/asp.net-core-tutorial/tree/master/chapter-02

3、准备工作

安装MySQL数据库：https://dev.mysql.com/downloads/mysql/

• Windows环境

下载安装包后双击安装，一直下一步即可。

• MacOS环境

参考：https://ken.io/note/macos-mysql8-install-config-tutorial

• CentOS环境

参考：https://ken.io/note/centos-mysql8-setup

4、前置知识

• 控制反转（IOC）原则与依赖注入（DI）

ASP.NET Core 默认集成了DI。所有官方模块的引入都要使用DI的方式引入。

https://baike.baidu.com/item/IOC

• Linq使用教程

https://docs.microsoft.com/zh-cn/dotnet/csharp/tutorials/working-with-linq

二、EF Core + MySQL 前置准备

EF Core 全称：Entity Framework Core，为微软为 .NET Core平台开发的ORM框架。对应是 .NET Framework平台的 Entity Framework（EF），无论是EF还是EF Core都可以说是 .NET 平台开发效率最高的ORM框架。

1、引入 EF Core + MySQL Provider

EF Core已经集成在 ASP.NET Core 中，但默认并不支持MySQL，如果需要连接MySQL,需要添加MySQL相关的Provider，这里我选择的是：Pomelo.EntityFrameworkCore.MySql

任意命令行操作即可，我用的是VS Code自带的命令行

//进入项目根目录： Ken.Tutorial.Web
cd Ken.Tutorial.Web

//添加Package
dotnet add package Pomelo.EntityFrameworkCore.MySql

这里我添加的 MySql.Data.EntityFrameworkCore 版本是 8.0.13，如果你想跟我使用一样的版本，可以使用以下命令：

dotnet add package Pomelo.EntityFrameworkCore.MySql --version 2.1.4

2、创建MySQL库表

• 创建数据库

CREATE DATABASE ken_tutorial;

• 创建表

USE ken_tutorial;

DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL,
  `age` int(11) DEFAULT NULL,
  `hobby` varchar(500) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

3、配置链接字符串

在项目根目录Ken.Tutorial.Web中创建配置文件appsettings.json,并写入以下配置

{
   
  "ConnectionStrings": {
   
    "testdb": "server=localhost;database=Ken.Tutorial;uid=root;pwd=root;"
  }
}

4、实体&DbContext准备

创建user表对应实体

在项目根目录Ken.Tutorial.Web中创建目录Models,并在其中创建类：UserEntity.cs

using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace Ken.Tutorial.Web.Models
{
   
    [Table("user")]
    [Serializable]
    public class UserEntity
    {
   
        [Key]//主键
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]//自增列
        [Column("id")]
        public int Id {
    get; set; }

        [Column("name")]
        public string Name {
    get; set; }

        [Column("age")]
        public int Age {
    get; set; }

        [Column("hobby")]
        public string Hobby {
    get; set; }
    }
}

创建DBContext

在项目根目录Ken.Tutorial.Web中创建目录Repositories,并在其中创建类：TutorialDbContext.cs

using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;

namespace Ken.Tutorial.Web.Repositories
{
   
    public class TutorialDbContext : DbContext
    {
   
        private IConfiguration Configuration {
    get; }

        public TutorialDbContext(IConfiguration configuration)
        {
   
            this.Configuration = configuration;
        }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
   
            optionsBuilder.UseMySql(Configuration.GetConnectionString("testdb"));
        }
        
        ppublic DbSet<UserEntity> Users {
    get; set; }
    }
}

TutorialDbContext 继承了 DbContext，然后再Context初始化时配置MySQL链接。

由于 ASP.NET Core 默认使用了DI组件，所以我们取配置文件，就需要在构造函数中获取 IConfiguration 注入的实例。