打算把之前開源的基于ASP.Net Core開發一套通用后臺框架重新用ASP.Net Core 5寫一遍，也算是鞏固一下舊知識，學習下新知識，本文是專案搭建初期關于 EF Core 的使用記錄

1、專案結構

LYAdmin專案結構.png

2、添加參考

LY.Admin.Model專案添加Microsoft.EntityFrameworkCore的NuGet參考，因為我們如果物體屬性需要使用資料批注方式而不是使用Fluent API的話是需要用到的，
LY.Admin.Repositories專案添加Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.Design、Microsoft.EntityFrameworkCore.Tools、Pomelo.EntityFrameworkCore.MySql的NuGet參考以及LY.Admin.Model的專案參考，
LY.Admin.Web專案添加Microsoft.EntityFrameworkCore.Design、Pomelo.EntityFrameworkCore.MySql的NuGet參考以及LY.Admin.Repositories的專案參考，

3、創建Model

物體屬性有資料批注和Fluent API兩種，我們這里兩種混合使用，實際專案中只需要一種就可以了，

Entity

我們所有表基本都是有通用欄位的，那么把這些通用欄位放到一個父類中更好處理，

   public class Entity
    {
        /// <summary>
        /// Id
        /// </summary>
        [Key]
        [Column("id")]
        [Comment("主鍵Id")]
        public int Id { get; set; }
        /// <summary>
        /// 洗掉標識
        /// </summary>
        [Column("delete_flag")]
        [Comment("洗掉標識")]
        public int DeleteFlag { get; set; }
        /// <summary>
        /// 創建人
        /// </summary>
        [Column("created_by")]
        [Comment("創建人")]
        public int CreatedBy { get; set; }
        /// <summary>
        /// 創建時間
        /// </summary>
        [Column("created_time")]
        [Comment("創建時間")]
        public DateTime CreatedTime { get; set; }
        /// <summary>
        /// 更新人
        /// </summary>
        [Column("update_by")]
        [Comment("更新人")]
        public int? UpdatedBy { get; set; }
        /// <summary>
        /// 更新時間
        /// </summary>
        [Column("update_time")]
        [Comment("更新時間")]
        public DateTime? UpdatedTime { get; set; }
    }

4、Post(演示表)

Author欄位我們使用Fluent API

[Table("tb_post")]
public class Post : Entity
{
    /// <summary>
    /// 標題
    /// </summary>
    [Column("title")]
    [Comment("標題")]
    public string Title { get; set; }
    /// <summary>
    /// 內容
    /// </summary>
    [Column("body")]
    [Comment("內容")]
    public string Body { get; set; }
    /// <summary>
    /// 作者 這里使用 Fluent API 方式去控制 具體見 LY.Admin.Repositories.Database.EntityConfigurations.PostConfiguration
    /// </summary>
    public string Author { get; set; }
}

5、創建DbContext

如果使用Fluent API是需要在OnModelCreating進行設定的代碼如下

DbContext

public class LYAdminDbContext:DbContext
{
    /// <summary>
    /// 建構式 呼叫父類建構式
    /// </summary>
    /// <param name="options"></param>
    public LYAdminDbContext(DbContextOptions<LYAdminDbContext> options) : base(options)
    {

    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);
        
        #region 物體屬性 
        // 參考 https://docs.microsoft.com/zh-cn/ef/core/modeling/entity-properties
        // 可以使用 資料批注 或者 Fluent API
        modelBuilder.ApplyConfiguration(new PostConfiguration()); 

        #endregion
    }
    public DbSet<Post> Posts { get; set; }
}

PostConfiguration

這里是每個物體類都單獨寫的,更多API查看物體屬性

/// <summary>
/// 物體屬性
/// 參考 https://docs.microsoft.com/zh-cn/ef/core/modeling/entity-properties
/// 可以使用 資料批注 或者 Fluent API
/// </summary>
public class PostConfiguration : IEntityTypeConfiguration<Post>
{
    public void Configure(EntityTypeBuilder<Post> builder)
    {
        builder.Property(x => x.Author).HasMaxLength(50).HasColumnType("varchar(50)").HasColumnName("author").HasComment("作者");
    }
}

6、LY.Admin.Web

修改Startup

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();

    services.AddDbContext<LYAdminDbContext>(options =>
    {
        var connectionString = this.Configuration["ConnectionStrings:MySqlConn"];
		//這里現在需要指定版本，暫時設定為自動檢測
        options.UseMySql(connectionString,ServerVersion.AutoDetect(connectionString));
    });
}

appsettings.json配置連接字串

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "MySqlConn": "Server=127.0.0.1;Port=3306;Database=lyadmin;Uid=root;Pwd=123456;charset=utf8;Allow User Variables=True"
  }
}

7、資料遷移

打開工具->NuGet包管理器->程式包管理器控制臺,默認專案選擇LY.Admin.Repositories，輸入命令Add-Migration Init，
不出意外可以看到上述專案下自動生成了Migrations檔案夾和代碼，
Migrations檔案夾和代碼.png
如果此時我們覺得又有新的修改，可以直接洗掉當前遷移檔案Remove-Migration，
修改完成后重新添加，然后執行Update-DataBase,就可以在資料庫中看到結果了，
表結構.png