学习ASP.NET Core Blazor编程系列一——综述

学习ASP.NET Core Blazor编程系列二——第一个Blazor应用程序（上）

学习ASP.NET Core Blazor编程系列二——第一个Blazor应用程序（中）

学习ASP.NET Core Blazor编程系列二——第一个Blazor应用程序（下）

学习ASP.NET Core Blazor编程系列二——第一个Blazor应用程序（完）

从本篇文章开始我们从头开始学习如何创建一个图书租赁系统。

在本篇文章中我们先来学习创建一个书籍信息的实体类，并且通过实体框架（EF Core）使用这个书籍实体类来处理书籍信息数据。

EF Core是一个轻量化、可扩展、开源和跨平台的对象关系映射（ORM）框架，它简化了编写数据库访问的代码。EF Core支持多个数据库引擎。

EF Core使用模型执行数据访问。模型是由实体类和表示数据库会话的上下文对象构成。上下文对象允许查询并保存数据。

创建的实体类被称为POCO类（“普通的CLR对象”）因为他们没有在EF Core中有任何依赖。它们定义存储在数据库中的数据的属性。

一、添加一个实体类

1. 在Visual Studio 2022的解决方案资源管理器中，右键单击该RlazorAppDemo，在弹出菜单中选择，项目-->添加-->新建文件夹，修改文件夹名称为“Models”。如下图。

2. 在Visual Studio 2022的解决方案资源管理器中，鼠标右键单击“Models”文件夹。在弹出菜单中选择，添加-->类。类名为Book。如下图。

3.在book类中的代码文件中添加以下属性 。

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Linq;
using System.Threading.Tasks;

namespace BlazorAppDemo.Models
{
public class Book
{
private string name = String.Empty;
private string author=String.Empty;

    \[Key\]  
    public int ID { get; set; }  
    public string Name { get => name; set => name = value; }  
    public DateTime ReleaseDate { get; set; }  
    public string Author { get => author; set => author = value; }  
    public decimal Price { get; set; }  
    /// <summary>  
    /// 图书类型编号  
    /// </summary>  
    public string Type { get; set; }  
    /// <summary>  
    /// 页码  
    /// </summary>  
    public int TotalPages { get; set; }  
    /// <summary>  
    /// 库存数量  
    /// </summary>  
    public int StockQty { get; set; }  
    /// <summary>  
    /// 现存量  
    /// </summary>  
    public int Qty { get; set; }

}  

} 

其中ID字段必须是数据库中表Book的主键。

二、添加数据库上下文类

在Visual Studio 2022的解决方案资源管理器中，鼠标右键单击“Models”文件夹。在弹出菜单中选择，添加-->类。类名为BookContext.cs类，继承自DbContext，操作方式如上第2点中的图所示，代码如下：

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

namespace BlazorAppDemo.Models
{

public class BookContext:DbContext

{  
    public BookContext(DbContextOptions<BookContext> options)

           : base(options)

    {           

    }

    public DbSet<Book> Book { get; set; }

}  

}

之前的代码中我们创建了一个DbSet类型的属性Book.在实体框架中，实体集合通过对应数据库中的表，实体对应表中的行。

三、添加数据库连接字符串

在Visual Studio 2022中的资源管理器中找到appsettings.json文件，用鼠标双击打开，在文件中添加一个连接字符串,代码如下。

{

"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}

},

"ConnectionStrings": {
"BookContext": "Server=.;Database=Books;Trusted_Connection=True;MultipleActiveResultSets=true"
},
"AllowedHosts": "*"

} 

四、注册数据库上下文

1.代码写到这时，我们发现刚才写的代码，特别是BookContext.cs中的代码，如下图红框处，出现了波浪线。这表明我们的依赖项中没有EntityFrameCore相关的组件。

2.在Visual Studio 2022的资源管理器中，在“依赖项”上点击鼠标右键，在弹出菜单中选择“管理Nuget程序包”。如下图。

3.在浏览界面的搜索框中输入以下四个包的名称。如下图。找到之后分别安装好。

4. 在Visual Studio 2022中的资源管理器中，鼠标右键单击“Data文件夹。在弹出菜单中选择，添加-->类。类名为ConfigHelper。这个类用来读取appsettings.json文件中的配置信息。代码如下。

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.Json;

namespace BlazorAppDemo.Data
{

public class ConfigHelper

{

    public static IConfiguration Configuration { get; set; }

    static ConfigHelper ()  
    {

        //ReloadOnChange = true 当appsettings.json被修改时重新加载         

        Configuration = new ConfigurationBuilder()  
        .Add(new JsonConfigurationSource { Path = "appsettings.json", ReloadOnChange = true })  
        .Build();  
    }  

}
}

5. 在Visual Studio 2022中的资源管理器中找到Program.cs文件，用鼠标双击打开，在Program.cs文件的var app = builder.Build();这一行代码前面写入依赖注入容器注册数据库上下文的代码，具体代码如下。

builder.Services.AddDbContextFactory(opt =>
opt.UseSqlServer(JsonHelper.Configuration["ConnectionStrings:BookContext"]));

6. 最后，在Visual Studio 2017中的菜单中选择“生成-->生成解决方案”对项目进行编译，以验证自己写的代码没有任何错误同。

五、EFCore支持的数据库

每个DbContext实例都必须配置为使用一个且仅一个数据库提供程序。（DbContext子类型的不同实例可用于不同的数据库提供程序，但单个实例只能使用一个。）使用特定的 Use*" 调用配置数据库提供程序。例如，上面代码中我们使用SQL Server数据库提供程序。

builder.Services.AddDbContextFactory(opt =>
opt.UseSqlServer(JsonHelper.Configuration["ConnectionStrings:BookContext"]));

　　这些 Use*" 方法是由数据库提供程序实现的扩展方法。 这意味着必须先安装数据库提供程序 NuGet 包，然后才能使用扩展方法。

　　EF Core 数据库提供程序广泛使用扩展方法。下表包含常见数据库提供程序的示例：

配置示例

NuGet 程序包

SQL Server 或 Azure SQL

.UseSqlServer(connectionString)

Microsoft.EntityFrameworkCore.SqlServer

Azure Cosmos DB

.UseCosmos(connectionString, databaseName)

Microsoft.EntityFrameworkCore.Cosmos

SQLite

.UseSqlite(connectionString)

Microsoft.EntityFrameworkCore.Sqlite

EF Core 内存中数据库

.UseInMemoryDatabase(databaseName)

Microsoft.EntityFrameworkCore.InMemory

PostgreSQL*

.UseNpgsql(connectionString)

Npgsql.EntityFrameworkCore.PostgreSQL

MySQL/MariaDB*

.UseMySql((connectionString)

Pomelo.EntityFrameworkCore.MySql

Oracle*

.UseOracle(connectionString)

Oracle.EntityFrameworkCore