C# 資料操作系列 - 5. EF Core 入門

C# 資料操作系列 - 5. EF Core 入門

0.前言

上一章簡單介紹了一下ORM架構，并手寫了一個類似ORM的工具類。這一章将介紹一個在C#世界裡大名鼎鼎的ORM架構——Entity Framework的Core版。

Entity Framework 非Core版目前已經更新到了6代，這是一款經過檢驗的ORM架構。在這裡簡單介紹一下Entity Framework（簡稱EF，額，别拿這個當關鍵字搜尋，要不然你會被忽悠到一個英語教育訓練機構的）的優點。

C#的設計理念是約定優于配置，意思就是通過一定程度的規範性格式化的寫法來避免使用配置檔案或者配置代碼等。而EF可以說是很好的诠釋了這個理念。

EF可以在不使用任何配置的前提下，自動解析類與表之間的映射（具體的映射邏輯與我們手寫的ORM工具類一緻或相近）。

自動跟蹤更改。在直接使用通過EF擷取的元素時，EF會自動跟蹤哪些字段發生了變化，當手動調用儲存的時候，EF就會把資料回傳給資料庫。

可以延遲加載需要的資料，外鍵引用屬性、查詢結果等

豐富的映射關系，支援一對一，一對多，多對多，甚至繼承、單表多執行個體等

可以使用Linq 進行查詢

非Core版的可以通過資料庫表生成實體類，兩種都可以通過實體類生成表

基于 ADO.NET 的資料庫連接配接和可用于連接配接到 SQL Server、Oracle、MySQL、SQLite、PostgreSQL、DB2 等

當然，還有一個特點：EF是約定優于配置，是以EF也可以配置。EF可以使用Fluent式配置，也可以使用配置檔案進行配置。

說了一大堆Entity Framework的優點，那麼就讓我們開始使用Entity Framework Core吧。

這裡簡單介紹一下選擇Core的原因，微乳這幾年一直在主推跨平台戰略。因為EF更多的是基于.NET Framework開發的，是以微軟以EF為基礎針對.net core做了一定的修改，然後EF Core誕生了。可以說EF Core是專門為.net core開發的。而且.net core有更多更好的發展。

1. Entity Framework Core安裝

   現在就讓我們一起來試着用一下EntityFramework Core吧。

先建立一個項目：

Visual Studio

點下一步，選擇Console程式：

點選建立

Visual Studio Code

dotnet new console -o ef_demo

cd ef_demo

然後用VS Code打開 ef_demo目錄。

然後選擇資料庫：

這次與之前的選擇不太一樣，這次選擇 SQLite這個資料庫。這是一個超小型的資料庫，可以不用安裝任何附加軟體，隻要有一個檔案，然後通過代碼就可以通路了。

接下來，添加 EF的SQLite包：

在非Visual Studio環境下，安裝一個三方庫可以使用：

dotnet add package Microsoft.EntityFrameworkCore.Sqlite

這個指令進行安裝。這是dotnet指令行安裝三方包的指令。對于Visual Studio或者Rider都可以通過圖形化的NuGet安裝三方包。

如果是使用NuGet的指令行界面進行安裝的話，可以通過：

Install-Package Microsoft.EntityFrameworkCore.Sqlite

這行指令來安裝NuGet包。

1. 入門級使用方式

   先建立兩個實體類：

public class ModelA

{

public int Id { get; set; }
public string Name { get; set; }
public List<ModelB> ModelBs { get; } = new List<ModelB>();           

}

public class ModelB

public int Id { get; set; }
public string Name { get; set; }
public int ModelAId { get; set; }
public ModelA modelA { get; set; }           

然後建立一個繼承自

Microsoft.EntityFrameworkCore.DbContext

的上下文類：

public class DefaultContext: DbContext

public DbSet<ModelA> ModelAs { get; set; }
public DbSet<ModelB> ModelBs { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder options)
    => options.UseSqlite("Data Source=blogging.db");           

注意在 OnConfiguration方法裡設定連接配接字元串。

如果是使用的已有資料的資料庫，則不需要進行下面的步驟，否則建議執行以下步驟，以便可以由EF Core提供的工具生成資料庫：

在 NuGet的控制台界面，輸入以下指令：

Install-Package Microsoft.EntityFrameworkCore.Tools

Add-Migration InitialCreate

Update-Database

或者在指令行界面輸入：

dotnet tool install --global dotnet-ef

dotnet add package Microsoft.EntityFrameworkCore.Design

dotnet ef migrations add InitialCreate

dotnet ef database update

執行成功之後會在項目根目錄下多出以下内容：

這是EF Core保留的遷移記錄，以便下次使用。

如果項目根目錄裡沒有 blogging.db 這個SQLite檔案的話，會自動建立該檔案，同時設定好表；如果有，但不是SQLite的檔案，則會報錯。

使用工具連接配接到blogging.db資料庫，可以看到 EF自動生成的兩個實體類對應表的DDL：

CREATE TABLE "ModelBs" (

"Id" INTEGER NOT NULL CONSTRAINT "PK_ModelBs" PRIMARY KEY AUTOINCREMENT,
"Name" TEXT NULL,
"ModelAId" INTEGER NOT NULL,
CONSTRAINT "FK_ModelBs_ModelAs_ModelAId" FOREIGN KEY ("ModelAId") REFERENCES "ModelAs" ("Id") ON DELETE CASCADE           

);

-- auto-generated definition

create table ModelAs

(

Id   INTEGER not null
    constraint PK_ModelAs
        primary key autoincrement,
Name TEXT           

先略過自動映射的關系，我們來看看如何使用：

var context = new DefaultContext();

//添加

context.Add(new ModelA { Id = 10, Name = "測試" });

context.SaveChanges();//儲存資料到資料庫中

//查詢

var modelA = context.ModelAs.Where(p => p.Id > 1).First();

//更新

modelA.Name += DateTime.Now;

context.SaveChanges();

//删除

context.Remove(modelA);

context.Dispose();

這裡簡單的示範了一下如何使用，到目前為止EF Core可以滿足了入門的開發。當然，EF并不隻有這些。下一篇将介紹如何自定義映射關系。

原文位址

https://www.cnblogs.com/c7jie/p/12889091.html