学习ASP.NET Core Blazor编程系列三——实体

本是古典何须时尚 2024-03-16 13:11 11阅读 0赞

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

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

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

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

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

**一、添加一个实体类**

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

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

![5ab85de5cdf2b20d198626d6210d95a2.png][]

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

![8496079bc575c5da14c9f114b55b0a6d.gif][]

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; }
 
 }
 }

![a8a37b25866eed157fc07d56d269c3fc.gif][]

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

**二、添加数据库上下文类**

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

![f9ad0a95c961fab66c188333b0cf9ec3.gif][]

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; }
 
 }
 }

![b143816c75e9a6bd7d5a5165291d69f2.gif][]

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

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

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

![c15cb180fce848cea324f00c9538a89b.gif][]

{
    
      "Logging": {
        "LogLevel": {
          "Default": "Information",
          "Microsoft.AspNetCore": "Warning"
        }
    
      },
    
      "ConnectionStrings": {
        "BookContext": "Server=.;Database=Books;Trusted_Connection=True;MultipleActiveResultSets=true"
      },
        "AllowedHosts": "*"
    
      }

![5e8f1a3f00093c50e79af66cf7db7df0.gif][]

**四、注册数据库上下文**

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

![3b53e63422bb5e4bb9b69fdb6413b450.png][]

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

![f34802b5baf4bbdfacddb43eed0d4260.png][]

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

![7da919016dedc400f802b13afcf77684.png][]

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

![fdad225a82456a01bdbc7d453ced2150.gif][]

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();
            } 
    }
    }

![b921115565419cb29d3a2b42e46c35cc.gif][]

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

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

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

五、EFCore支持的数据库

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

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

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

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

<table> 
 <tbody> 
 <tr> 
 <td> </td> 
 <td> </td> 
 <td> </td> 
 </tr> 
 <tr> 
 <td> SQL Server 或 Azure SQL </td> 
 <td> .UseSqlServer(connectionString) </td> 
 <td> Microsoft.EntityFrameworkCore.SqlServer </td> 
 </tr> 
 <tr> 
 <td> Azure Cosmos DB </td> 
 <td> .UseCosmos(connectionString, databaseName) </td> 
 <td> Microsoft.EntityFrameworkCore.Cosmos </td> 
 </tr> 
 <tr> 
 <td> SQLite </td> 
 <td> .UseSqlite(connectionString) </td> 
 <td> Microsoft.EntityFrameworkCore.Sqlite </td> 
 </tr> 
 <tr> 
 <td> EF Core 内存中数据库 </td> 
 <td> .UseInMemoryDatabase(databaseName) </td> 
 <td> Microsoft.EntityFrameworkCore.InMemory </td> 
 </tr> 
 <tr> 
 <td> PostgreSQL* </td> 
 <td> .UseNpgsql(connectionString) </td> 
 <td> Npgsql.EntityFrameworkCore.PostgreSQL </td> 
 </tr> 
 <tr> 
 <td> MySQL/MariaDB* </td> 
 <td> .UseMySql((connectionString) </td> 
 <td> Pomelo.EntityFrameworkCore.MySql </td> 
 </tr> 
 <tr> 
 <td> Oracle* </td> 
 <td> .UseOracle(connectionString) </td> 
 <td> Oracle.EntityFrameworkCore </td> 
 </tr> 
 </tbody> 
</table>

[86d8fb0d0936a2c2e80208965e981c0c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/9ab0722d9ba24eac9ac73bf58a78bf09.png
[5ab85de5cdf2b20d198626d6210d95a2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/cfcca318d6b74119abf1d1721e886de5.png
[8496079bc575c5da14c9f114b55b0a6d.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/474c1de84b1b486ab9c993c0d7640d23.png
[a8a37b25866eed157fc07d56d269c3fc.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/bf9a74f9fd144f23ba2e7d4fe90805dd.png
[f9ad0a95c961fab66c188333b0cf9ec3.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/eb788bfe380b495cbbb628770ad73013.png
[b143816c75e9a6bd7d5a5165291d69f2.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/0fe6834d94d14e39950bf5e1af1c4855.png
[c15cb180fce848cea324f00c9538a89b.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/8eeb8127dec6495781d38bce537203a2.png
[5e8f1a3f00093c50e79af66cf7db7df0.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/e6570410be534e6fa28d793eb789792e.png
[3b53e63422bb5e4bb9b69fdb6413b450.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/228d74e1dd8344edad6dc7476f81f0c0.png
[f34802b5baf4bbdfacddb43eed0d4260.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/06361c9d813a4220b8ee621d1d88e198.png
[7da919016dedc400f802b13afcf77684.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/b1682529b99247dcacf463c6594d3841.png
[fdad225a82456a01bdbc7d453ced2150.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/72819a7009314fe3bc12d8dd1d6618a8.png
[b921115565419cb29d3a2b42e46c35cc.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/cabab41bdb104b589731c0b4274ea95d.png