一、前言
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
注入的实例。