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 的内容，只有两个字段，对应 20190109031435_forum_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