Dapper怎么执行Insert操作 Dapper插入数据教程

来源：这里教程网时间：2026-02-21 17:35:13 作者：

用 Dapper 执行 Insert 操作非常直接：写 SQL 插入语句，调用

connection.Execute()

方法即可。它不自动生成 SQL，也不做模型映射（除非你手动传参），核心就是“SQL + 参数化”。

基础 Insert 写法（推荐参数化）

避免拼接字符串，防止 SQL 注入。Dapper 会自动把对象属性或匿名对象的字段映射为 SQL 参数：

用类实例插入：

  var user = new { Name = "张三", Email = "zhang@example.com", Age = 25 };
  using var conn = new SqlConnection(connStr);
  conn.Execute("INSERT INTO Users (Name, Email, Age) VALUES (@Name, @Email, @Age)", user);

用匿名对象更轻量，适合简单场景；用强类型类（如
User
）更适合复用和校验。

获取插入后的自增 ID（SCOPE_IDENTITY）

如果表主键是

IDENTITY

，常用

SELECT SCOPE_IDENTITY()

获取刚插入的 ID：

把 INSERT 和 SELECT 合并在一条命令里，用
ExecuteScalar<int>()</int>
：

  var newId = conn.ExecuteScalar(@"
    INSERT INTO Users (Name, Email) VALUES (@Name, @Email);
    SELECT CAST(SCOPE_IDENTITY() AS INT);",
    new { Name = "李四", Email = "li@example.com" });

注意返回类型要匹配（比如
int
、
long
），SQL Server 中
SCOPE_IDENTITY()
默认是
decimal
，所以显式转成整型更稳妥。

批量插入（少量数据可用，大量建议 SqlBulkCopy）

Dapper 本身不提供原生批量插入，但可以循环执行

Execute

或用事务包住多条语句提升性能：

带事务的多条插入：

  using var conn = new SqlConnection(connStr);
  conn.Open();
  using var tran = conn.BeginTransaction();
  try
  {
    conn.Execute("INSERT INTO Logs (Msg, Level) VALUES (@Msg, @Level)",
      new[] {
        new { Msg = "Start", Level = "Info" },
        new { Msg = "Done", Level = "Info" }
      }, tran);
    tran.Commit();
  }
  catch
  {
    tran.Rollback();
    throw;
  }

几百条以内用这个够用；上万条请改用
SqlBulkCopy
或第三方扩展如
Dapper.FastCrud
、
DapperExtensions
。

注意事项和常见坑

实际用的时候容易忽略这些细节：

字段名和参数名必须严格一致（大小写敏感取决于数据库配置，SQL Server 默认不区分，但建议统一小写）； NULL 值要传
null
，别传空字符串或默认值，否则可能违反 NOT NULL 约束； DateTime 字段注意时区，.NET 的
DateTime
默认是
DateTimeKind.Unspecified
，入库前建议明确指定
DateTimeKind.Utc
； 字符串长度超限会报错，Dapper 不做截断，需业务层或数据库约束控制。

基本上就这些。Dapper 的 Insert 不复杂，但容易忽略参数命名和事务处理。写清楚 SQL，配好参数，再加点异常兜底，就能稳稳落地。