Dapper执行Insert操作需手写SQL并调用Execute()，支持参数化（类实例或匿名对象）、获取自增ID（SELECT SCOPE_IDENTITY()）、事务批量插入；注意参数名一致、NULL值处理、DateTime时区及字符串长度。
用 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：()
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，配好参数，再加点异常兜底，就能稳稳落地。
