ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程

内容纲要

SQLIte 操作方便,简单小巧,这里笔者就不再过多介绍,感兴趣可以到以下博文

https://blog.csdn.net/qq_31930499/article/details/80420246

 文章介绍创建ASP.NET Core 程序,创建模型、上下文,生成数据库,对数据库增删查改。

并对每个过程进行详细介绍,使初学者尽快了解内容和相关知识,避免对某一知识点怀疑、卡在某个位置。


 过程&目录

1 新建ASP.NET Core MVC 应用

  1.1 新建MVC应用

   1.2 引入NuGet 包

 2 新建模型和上下文

  2.1 新建模型类

  2.2 新建上下文

3 配置服务

4 生成数据库

5 使用工具管理SQLite文件

6 生成增删查改基架

7 数据验证


 

1 新建ASP.NET Core MVC 应用

  1.1 新建MVC应用

打开Visual Studio 2017,新建 ASP.NET Web应用程序,选择 MVC(模型视图控制器)。

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

 1.2 引入NuGet 包

   需要 引入 

  • microsoft.EntityFrameworkCore
  • Microsoft.EntityFrameworkCore.Sqlite

 引入教程

点击

依赖项

    -右键

       –管理NuGet 程序包

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

轮流输入并安装 microsoft.EntityFrameworkCore  、 Microsoft.EntityFrameworkCore.Sqlite,下面附过程

注:

版本请选择与自己 ASP.NET Core 版本接近的。

笔者版本 ASP.NET Core 版本为 2.1 ,选择的 NuGet 包版本为 2.11。

如果你的 .Net Core 是最新的,那么 NuGet 也选最新的即可。

如果你选择版本后,发现报错,可以再进入 NuGet  重新删除安装。

出现更新提示千万不用更新。

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》


 

 2 新建模型和上下文

这一步建立模型和上下文,后面将会根据这里的代码生成数据库和数据库表!

需要建立一个上下文类和模型类,把模型类包含在上下文类中,上下文类中包含进来的模型类,将会生成对应的数据库表。

下面这代码不用自己操作,只需要看就行。(注意红色加粗部分)

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
namespace WebApplication1.Models
{
    public class SqlContext:DbContext
    {
        public SqlContext(DbContextOptions<SqlContext> Options):base(Options)
        {
        }
        public DbSet<A> A { get; set; } //在数据库中生成数据表A

    }

    public class A
    {
        public int ID { get; set; }
       }
public class B { public int ID { get; set; } } }

上面代码,有三个类,

  • 其中  SqlContext 类是上下文类,
  • A、B类为模型类,
  • 但是,只让A生成数据库表,而B不会生成数据库表。
  • A、B都是模型类,因为可以被生成数据库表,所以A也可以叫实体类,B因为没有 DbSet<B> ,所以B叫模型类,不叫实体类。
  • A类将会生成一个真实的数据库中的表,有对应关系,所以,他是“实体类”。
  • B类没有对应的存在,只是模型,没有实际存在的对象,所以只是叫“模型类”。

 

2.1 新建模型类

上面代码把模型类、上下文类放到同一个文件 SqlContext.cs,这样可读性不太好。

因为一个模型类,代表一个数据表,上下文类相当于一个配置类,一个数据库有几十个表,每个表有几个列,这样会使文件内容过于复杂。

我们可以降低耦合,每个类文件只存在一个类,每个类代表一个表,你要创建几个表,就对应写几个类。

实际操作

在 Models 文件夹中

  • 新建一个类  Users.cs
  • 在类中直接写代码
        public int ID { get; set; }       //主键
        public string Name { get; set; }  //用户名称
        public int Age { get; set; }    //用户年龄
        public int Number { get; set; } //用户手机号码

如图

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

注:

一个模型类  对应 一个数据表(Table)

模型类的一个属性  对应一个列。

模型类只应出现属性,不应该出现方法等。

 笔者这里只写一个表,如果你想要多个表,可以新建其它类,然后在上下文类中加入。

 

2.2 新建上下文

上面已经建立模型类,模型类将成为数据表(Table)本身。然而他们不能直接对应生成数据表,需要上下文来对模型类映射成数据表,不然他们只是普通的类。

Models 目录新建 类 MyContext.cs

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

在头部引入 EF( EntityFrameworkCore )

using Microsoft.EntityFrameworkCore;

 

重写 MyContext

步骤1 

  public class MyContext

改成

    public class MyContext:DbContext    //表示该类为上下文类,数据库名称为 My,类名称为什么,数据库名就为什么

 

步骤2

在MyContext类中写一个构造函数

        public MyContext(DbContextOptions<MyContext> options) : base(options)
        {

        }

这个构造函数涉及到依赖注入,这里不再赘述,只需要知道这个构造函数能够配置相关设置。

这里的构造函数内容为空,因为暂时没有什么要配置的。

 

步骤3

在构造函数下面加上代码,对模型类进行映射。

        public DbSet<Users> Uaa { get; set; }
//Dbset  映射成一个表
//Dbset<Users>   里面的Users即为使用的模型类
//Uaa      Users 类在数据库生成的名称

注:

上面代码表示以模型类Users为基础,在数据库中生成 名为 Uaa 的 表。

一个上下文对应 一个 数据库,上下文类 MyContext,Context 前面的部分将成为数据库名称。例如 asdwadaaContext,将生成数据库asdwadaa。

一个模型类  对应 一个数据表(Table)

完整代码如下

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;

namespace WebApplication1.Models
{
    public class MyContext:DbContext
    {
        public MyContext(DbContextOptions<MyContext> options) : base(options)
        {

        }
        public DbSet<Users> Uaa { get; set; }
    }
}

 

生成的效果图预览《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 


 

3 配置服务

为了让应用生成数据库、使用到这个数据库,需要在 Startup.cs 增加代码

在头部引入三个 库

using WebApplication1.Models;  //可能命名不同
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Sqlite;

然后为 应用注入服务,有以下方式

(后面再解释作用,现在先了解,不用加)

1 直接写字符串

在 Startup.cs 增加代码

            string connecttext = "Filename=F:\\MY.DB";
            services.AddDbContext<MyContext>(options=>options.UseSqlite(connecttext));

2 使用JSON

在 appsettings.json 文件加入内容(红色部分)

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "MyContext": "Filename=F:\\MY.DB"
  }
}

然后 在 Startup.cs 增加代码

            string connecttext = Configuration.GetConnectionString("MyContext");
            services.AddDbContext<MyContext>(options=>options.UseSqlite(connecttext));

 

 注:

以上两种方式,connecttext 变量的作用是获取数据库连接字符串,此变量没有特殊意义,只是为了增加可读性。

SQLite的连接字符串,只需要写  “Filename=[绝对路径]”

services.AddDbContext<MyContext>(options=>options.UseSqlite(“连接字符串”));
表示
    向应用注入DbContext (数据库上下文服务),注入的上下文类型为
MyContext>

(options=>options.UseSqlite(“连接字符串”)
是 lambda 表达式,表示使用 sqlite 数据库,参数是连接字符串。Lambda 表达式属于C# 基础知识,不会的话,先记着,以后查找资料。

来实际操作

请使用复制上面 方式一 的代码,然后在 Startup.cs 类 — ConfigureServices 方法里加入

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

直接复制下面代码覆盖 ConfigureServerices

        public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<CookiePolicyOptions>(options =>
            {
                // This lambda determines whether user consent for non-essential cookies is needed for a given request.
                options.CheckConsentNeeded = context => true;
                options.MinimumSameSitePolicy = SameSiteMode.None;
            });

            string connecttext = "Filename=F:\\MY.DB";
            services.AddDbContext<MyContext>(options => options.UseSqlite(connecttext));

            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

 

注:

SQLite 数据库文件,可以不加后缀名,但加上后缀名会便于别人识别这是一个数据库的文件,后缀名不限,可以为 .DB、.SQLite、SQLite3等。

 


 4 生成数据库

点击

  工具

    -NuGet 包管理器

      –程序包管理器控制台

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

输入

Add-Migration InitialCreate

等待结束后在输入

Update-Database

如图

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

然后你会发现解决方案管理器,多了 Migrations 目录和一些文件,F:\ 目录也多了一个MY.DB文件


5 使用工具管理SQLite文件

生成数据库文件后,会发现无法直接打开的,即使是 VS2017 也不行。

这时可以使用工具 SQLite Expert Professional ,来对 SQLIte 数据库进行管理。

下载地址 http://xzc.197746.com/SQLiteExpert5.zip

软件介绍 https://www.cr173.com/soft/36343.html

安装好软件后,即可打开数据库文件。

软件打开数据库文件教程:

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 


 

6 生成增删查改基架

这时候可以在程序对数据库进行操作,对于如何使用,最好去看微软的Entity Framework文档。

笔者这里给出一个简单的示例。

步骤 1

在 Controller 目录,右键点击 添加 — 新建基架的项目

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

 步骤 2

点击 视图使用 Entity Framework 的 MVC 控制器

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

模型类 选择 Users([项目名称].Models)

数据库上下文选择  MyContext ([项目名称].Models)

点击 添加

 

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

步骤3 

这时可以看到

Controller 多了 UsersController.cs 文件

Views 多了 Users 目录

请点击 运行 或按 F5,启动网站

 在网站后面加上 Users

例如 https://localhost:[实际端口]/Users,就可以对Users表为所欲为了

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

步骤4  添加数据

点击 Create new

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

 

 结果

 

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 

 《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

 


 

7 填写数据不能为空

注:这里涉及到特性、数据验证,笔者不再赘述,读者可以先了解,然后翻译别的文章。

 

经过上面操作,我们已经可以对数据库进行操作,实际上,虽然可以操作数据,可是如果我想设置某个项必须填写呢,某个项的格式必须是手机呢?总不能让用户随便填吧?

打开 Users.cs

添加引用 

using System.ComponentModel.DataAnnotations;

修改Users类的代码如下

    public class Users
    {
        public int ID { get; set; }       //主键

        [Required]
        public string Name { get; set; }  /n/用户名称

        [Required(ErrorMessage ="不能为空")]
        public int Age { get; set; }    //用户年龄

        [Required]
        [RegularExpression(@"^1[3458][0-9]{9}$", ErrorMessage = "手机号格式不正确")]
        public int Number { get; set; } //用户手机号码
    }

 

运行网站,打开 URL/Users,点击 Create New,然后不用填写内容直接提交,会发现

 

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

填写其它项,然后在 Number一项乱填数字,会发现

《ASP.NET Core 使用 SQLite 教程,EF SQLite教程,修改模型更新数据库,适合初学者看懂详细、简单教程》

这个就是模型验证。

它不需要写什么代码,只要在属性上面加上 [特性]即可。

这方面知识,请另外查阅。

注:

  • [Required] 表示该项不能为空
  • [Required(ErrorMessage =”不能为空”)] ErrorMessage =”” 就是不按此要求填写,会出现额提示
  • [RegularExpression(@”^1[3458][0-9]{9}$”, ErrorMessage = “手机号格式不正确”)] 这是正则表达式验证,填写的内容不符合格式的话,会出现错误提示。

   

 

【完】

点赞

发表评论

电子邮件地址不会被公开。 必填项已用*标注