FreeSql 插入數據，如何返回自增值

FreeSql是一個功能強大的 .NET ORM 功能庫，支援 .NetFramework 4.0+、.NetCore 2.1+、Xamarin 等支援 NetStandard 所有運行平台。

以 MIT 開源協議託管於 github：https://github.com/2881099/FreeSql

FreeSql 插入數據的方式有多種，這篇文章教你用最優的方案做數據插入功能。

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()      .UseConnectionString(FreeSql.DataType.Sqlite, "Data Source=db1.db")      .UseAutoSyncStructure(true) //自動同步實體結構到資料庫      .Build(); //請務必定義成 Singleton 單例模式    public class Blog  {      [Column(IsIdentity = true, IsPrimary = true)]      public int BlogId { get; set; }      public string Url { get; set; }      public int Rating { get; set; }  }    var blog = new Blog  {      Url = "https://github.com/2881099/FreeSql",      Rating = 5  };

單條數據插入

如果表有自增列，插入數據後應該要返回 id。

方法1：(原始)

long id = fsql.Insert(blog).ExecuteIdentity();  blog.Id = id;

方法2：(依賴 FreeSql.Repository)

var repo = fsql.GetRepository<Blog>();  repo.Insert(blog);

將插入後的自增值，填充給 blog.Id

方法3：(依賴 FreeSql.DbContext)

using (var ctx = fsql.CreateDbContext())  {      ctx.Add(blog);      ctx.SaveChanges();  }

將插入後的自增值，填充給 blog.Id

批量插入

var items = new List<Topic>();  for (var a = 0; a < 10; a++)  {      items.Add(new Blog      {          Url = "https://github.com/2881099/FreeSql",          Rating = 5      });  }

方法1：(原始)

fsql.Insert(items).ExecuteAffrows();

無法返回 items 所有 id 值

方法2：(依賴 FreeSql.Repository)

var repo = fsql.GetRepository<Blog>();  repo.Insert(items);

將插入後的自增值，填充給所有 items.Id

當操作的是 SqlServer/PostgreSql 資料庫，此方法為一次執行，返回所有 id

當操作的是其他資料庫，此方法為循環多次執行，返回所有 id（注意性能問題）

大批量插入(SqlBulkCopy、BulkCopy)

針對 SqlServer/PostgreSQL/MySql 資料庫，目前能在以下實現使用：

  • FreeSql.Provider.SqlServer
  • FreeSql.Provider.PostgreSQL
  • FreeSql.Provider.MySqlConnector
fsql.Insert(items).ExecuteSqlBulkCopy();  fsql.Insert(items).ExecutePgCopy();  fsql.Insert(items).ExecuteMySqlBulkCopy();

另外 IInsert 方法提供了 ToDataTable() 方法返回 DataTable 對象，讓使用者自己封裝 BulkCopy 操作。

DataTable dt = fsql.Insert(items)      .InsertIdentity() //開啟自增 id 插入      .ToDataTable();

注意：InsertIdentity() 的功能是生成 SQL 的時候有值，而不是調用 SET IDENTITY ON;

參考資料

《新人學習指引》 | 《Select》 | 《Update》 | 《Insert》 | 《Delete》
《表達式函數》 | 《CodeFirst》 | 《DbFirst》 | 《BaseEntity》
《Repository》 | 《UnitOfWork》 | 《過濾器》 | 《樂觀鎖》 | 《DbContext》
《讀寫分離》 | 《分區分表》 | 《租戶》 | 《AOP》 | 《黑科技》 | 更新日誌

Tags:

VirMach 便宜 VPS