专栏首页DotNet程序园Asp.Net Core 轻松学-10分钟使用EFCore连接MSSQL数据库

Asp.Net Core 轻松学-10分钟使用EFCore连接MSSQL数据库

前言

    在 .Net Core 2.2中 Microsoft.AspNetCore.App 默认内置了EntityFramework Core 包,所以在使用过程中,我们无需再从 NuGet 仓库单独应用 EFCore 包;本文并不打算深入的介绍 EFCore 的各种使用方式、原理解析,本文重点在于解决让初学者在10分钟内快速使用上 EFCore 的问题。

1. Code First 方式

EFCore 支持 Code First 方式,这个特性允许开发人员基于业务实体模型创建数据库

1.1 首先创建一个 Asp.Net Core WebApi 项目 Ron.MSSQL,如下
1.2 创建业务实体模型文件夹 Models,添加两个业务实体 Topic,Post
public class Topic
    {
        public int Id { get; set; }
        public string Title { get; set; }
        public string Content { get; set; }
        public DateTime CreateTime { get; set; }
        public virtual ICollection<Post> Posts { get; set; }
    }

    public class Post
    {
        public int Id { get; set; }
        public int TopicId { get; set; }
        public string Content { get; set; }
        public DateTime CreateTime { get; set; }
        public virtual Topic Topic { get; set; }
    }

上面定义的两个实体对象之间通过 Topic.Posts 和 Post.Topic 属性建立了主外键关系,这两个表的主键为 Id,且类型为 int ,这表示在下面的创建数据库过程中,EFCore 会自动的为这两个实体对象建立关系和主键,并会自动设置 Id 字段为主键标识

1.3 编写数据库上下文对象,该对象必须继承自 DbContext

DbContext 内置了很多个构造函数,这里使用配置选项的方式,实现方式也非常简单,最终,在 ForumContext 类中定义上面的实体业务模型集合即可

public class ForumContext : DbContext
    {
        public ForumContext(DbContextOptions<ForumContext> options) : base(options)
        {

        }

        public DbSet<Topic> Topics { get; set; }
        public DbSet<Post> Posts { get; set; }
    }
1.4 在 appsettings.json 文件中配置数据库连接字符串,这里使用的是本机安装的 SQLExpress,指定数据库名称为:Forum
"ConnectionStrings": {
    "Forum": "server=.\\SQLEXPRESS;uid=sa;pwd=123456;database=Forum;"
  }
1.5 在 Startup.cs 中配置连接字符串,注入上下文对象
public void ConfigureServices(IServiceCollection services)
        {
            services.AddDbContext<ForumContext>(options =>
            {
                var connectionString = this.Configuration["ConnectionStrings:Forum"];
                options.UseSqlServer(connectionString);
            });

            ...
        }

上面的代码使用 AddDbContext方法,并配置了数据库连接字符串为配置文件中的 "ConnectionStrings:Forum" 节点的值

1.5 在项目的包管理器控制台中使用命令根据实体业务模型创建数据库

现在,打开项目中的包管理器控制台

  • 在控制台中输入以下两组命令
Add-Migration Forum_v1
Update-Database

在输入命令 Add-Migration Forum_v1 后,回车,控制台输出 To undo this action, use Remove-Migration. 表示命令执行成功;同时可以看到,在项目中多了一个文件夹 Migrations; 注意:此时,数据库 Forum 并没有被创建

在 Migrations 文件夹中;当执行 Update-Database 命令后,EFCore 设计工具将根据 Migrations 中的定义去创建数据库,最终,控制台输出 Done 表示创建完成

  • 查看数据库

从上图中可以看到,数据库创建成功,同时,Forum 数据库中还多了一个表 _EFMigrationsHistory ,该表存储的正是我们项目中的 Migrations 的内容,只有两个字段,对应 20190109031435Forum_v1.cs 和 当前使用的 EFCore 版本号 如果后续有增加实体,只需要再次执行 Add-Migration 命令即可 如果希望获得帮助,还可在包管理器控制台执行命令 get-help Add-Migration

1.6 在项目中执行 CURD 操作

至此,数据库创建完成,为了在控制器中使用 ForumContext 对象,我们在 HomeController 中使用依赖注入的方式获得 FormContext 对象,以备后续使用

private ForumContext context;
        public HomeController(ForumContext context)
        {
            this.context = context;
        }

现在,尝试着在项目中执行一些增删改查的工作,插入一条 Topic 记录,在 HomeController 中编写以下代码

[Route("api/[controller]"), ApiController]
    public class HomeController : ControllerBase
    {
        private ForumContext context;
        public HomeController(ForumContext context)
        {
            this.context = context;
        }
        [HttpGet]
        public ActionResult<IEnumerable<Topic>> Get()
        {
            var topics = context.Topics.ToList();

            return topics;
        }

        [HttpPost]
        public void Post([FromBody] TopicViewModel model)
        {
            context.Topics.Add(new Topic()
            {
                Content = model.Content,
                CreateTime = DateTime.Now,
                Title = model.Title
            });
            context.SaveChanges();
        }

        [HttpPut]
        public void Put([FromBody] TopicViewModel model)
        {
            var topic = context.Topics.Where(f => f.Id == model.Id).FirstOrDefault();
            topic.Title = model.Title;
            topic.Content = model.Content;
            context.Topics.Update(topic);
            context.SaveChanges();
        }

        [HttpDelete("{id}")]
        public void Delete(int id)
        {
            var topic = context.Topics.Where(f => f.Id == id).FirstOrDefault();
            context.Topics.Remove(topic);
            context.SaveChanges();
        }
    }

上面的代码定义了 Get/Post/Put/Delete 接口,这是一个标准的 Resetful API ,通过依次调用模拟对数据库的 CURD 操作

2. DB First 的使用方式

在很多时候,我们的开发方式是先设计好数据库模型,然后再生成实体对象,这种方式对于从其它语言迁移到 .Net Core 上非常友好,从现有数据库中生成实体对象非常简单,只需要一个命令即可,还是以上面创建好的数据库 Forum 为例子

2.1 基于现有数据库生成实体对象,在项目中的包管理器控制台输入命令,指定使用的是 Microsoft.EntityFrameworkCore.SqlServer 驱动,生成的实体模型输出到目录 DbModels 中

` Scaffold-DbContext "server=.\SQLEXPRESS;uid=sa;pwd=123456;database=Forum" Microsoft.EntityFrameworkCore.SqlServer -OutPutDir DbModels

2.2 执行结果

如果仅需要生成部分数据表,还可以通过将 -Tables 参数添加到上述命令来指定要为哪些表生成实体。 例如 -Tables Blog,Post。多个数据表以逗号分隔

2.3 项目中生成的实体对象文件夹

通过查看生成的代码比较,和 Code First 方式基本相同,使用方式完全一致

3. 导航属性

不管是 Code First 还是 DB First ,在实体对象中,我们都可以看到有个一个导航属性,比如 Topic.Posts 和 Post.Topic ,该导航属性定义了前缀 virtual 表示延迟加载此关联对象,在 Code First 中,导航属性还起到主外键关系定义的作用

结束语

  • 本文介绍两种使用 EF Core 的方式
  • 通过一个简单的 Forum 示例来一步一步的了解了 EFCore 的使用过程

示例代码下载

https://github.com/lianggx/EasyAspNetCoreDemo/tree/master/Ron.MSSQL

本文分享自微信公众号 - DotNet程序园(dotnetblog),作者:DotNet程序园

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2019-02-06

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • ​.NET手撸2048小游戏

    2048是一款益智小游戏,得益于其规则简单,又和 2的倍数有关,因此广为人知,特别是广受程序员的喜爱。

    梁规晓
  • Asp.Net Core 轻松学-被低估的过滤器

        过滤器,从我们开始开发 Asp.Net 应用程序开始,就一直伴随在我们左右;Asp.Net Core 提供多种类型的过滤器,以满足多种多样的业务应用场景...

    梁规晓
  • FreeSql 新的八大骚功能

    FreeSql 目前版本号 0.5.5,预计明年元旦发布 1.0.0,切莫小看了版本号,目前单元测试方法1350+,并且每个方法内的涵盖面又比较广(不信的话见下...

    梁规晓
  • 基于django的视频点播网站开发-step10-后台评论管理功能

    本讲中,我们会讲到评论管理功能,数据库中的每一条是来自用户的评价,因此后台中的评论管理只有评论列表和评论删除功能,没有增加评论和编辑评论。

    山东程序员
  • okhttp拦截器的使用------修改baseurl

    有的时候做项目的时候会遇到调用接口的url和之前接口定义的url不一样,很可能连retrofit已经设置好的baseurl都要换,但是retrofit并没有提供...

    提莫队长
  • 架构·微服务架构·ANDROID 源码分析(二)

    上一篇的文章架构·微服务架构详细描述微服务架构相关的理论基础,为这一篇文章打好了理论基础。这篇文章将站在 Android Framework 设计者的角度上,剖...

    幺鹿
  • 在ListView上使用自定义的Adapter

    需要实现的东西是: 一个DataListViewAdapter,当进行如下调用时,就能在列表上显示出数据:

    LeoXu
  • 抽象类总结及练习

    该篇文章只是说明抽象类的一个使用场景,由于小弟水平一般,如果有说的不对地方希望各位大牛们指出,也欢迎各位亲们补充。

    写代码的猿
  • springmvc3个适配器

    py3study
  • Python Docker 查看私有仓库镜像【转】

    踏歌行

扫码关注云+社区

领取腾讯云代金券