Dapper的Execute方法的返回值是什么意思 Dapper Execute返回值详解

Dapper的Execute方法返回int类型，表示SQL命令实际影响的数据库行数；插入成功返回1，批量插入返回N，UPDATE/DELETE返回匹配行数，0表示无匹配或冲突未执行，不反映执行成功与否。

Dapper 的 Execute 方法返回的是一个 int 类型的整数，它表示该 SQL 命令**实际影响的数据库行数**，不是执行成功与否的布尔值，也不是主键 ID 或其他业务值。

返回值就是“受影响行数”

这个数字直接对应数据库执行后报告的 rows affected。例如：

• 插入一条新记录且成功 → 返回 1
• 批量插入 5 条，全部成功 → 返回 5
• UPDATE 语句匹配到 3 行，其中 2 行字段值实际发生了变化 → 多数数据库（如 SQL Server、PostgreSQL）仍返回 3（只要 WHERE 匹配就计数，不管是否真正更新了数据）
• DELETE 条件没匹配到任何行 → 返回 0
• INSERT IGNORE 或 ON CONFLICT DO NOTHING 在发生冲突时未插入 → 返回 0（Dapper 能如实反映这一行为）

不等于“执行是否成功”

Execute 不抛异常 ≠ 操作成功；返回 0 ≠ 一定出错。它只管“行数”，异常由底层 ADO.NET 抛出（比如连接失败、语法错误、违反约束等）。所以：

• 返回 0 是完全合法的业务结果（如更新一个不存在的用户）
• 返回大于 0 也不代表业务逻辑正确（比如误删了多条）
• 需要结合业务语义判断：比如“新增用户”期望返回 1，若得 0 就该提示“用户名已存在”

和 Insert/Update/Delete 场景的对应关系

不同操作下返回值的典型含义：

• INSERT：通常为 1（单条）或 N（批量），但含唯一键冲突时可能为 0（取决于 SQL 写法，如用 INSERT IGNORE 或 ON CONFLICT）
• UPDATE：等于 WHERE 条件命中的行数，哪怕 SET 的值和原值一样（SQL Server 默认如此；MySQL 可配置是否严格检测变更）
• DELETE：等于被删除的行数，可为 0（无匹配）到任意正整数
• 存储过程调用：默认返回的是过程内最后一条可影响行数的语句的结果；如需获取 RETURN_VALUE，必须显式用 DynamicParameters 添加 ParameterDirection.ReturnValue 参数

常见误区提醒

几个容易混淆的点：

• ❌ 不是自增主键值 —— 想取新 ID 请用 ExecuteScalar 配合 OUTPUT INSERTED.Id 或 SELECT SCOPE_IDENTITY()
• ❌ 不是执行耗时或状态码 —— 它纯粹是数据库返回的整数
• ❌ 不会因事务回滚而返回负数 —— 回滚后 Execute 已不返回，而是抛出异常或由上层捕获
• ✅ 支持批量操作 —— 传入 List 实体或匿名对象集合时，返回的是所有批次累计影响行数

基本上就这些。理解 “返回值 = 数据库说改了几行”，就能避开大多数误判。

# mysql  # app  # 状态码  # .net  # sql  # select  # int  # delete  # 对象  # postgresql  # 数据库  # 行数  # 的是  # 返回值  # 抛出  # 主键  # 几个  # 这一  # 也不  # 就能  # 不存在 

相关文章： 重庆市网站制作公司,重庆招聘网站哪个好？  如何用搬瓦工VPS快速搭建个人网站？  如何撰写建站申请书？关键要点有哪些？  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  安徽网站建设与外贸建站服务专业定制方案  网页制作模板网站推荐,网页设计海报之类的素材哪里好？  建站之星各版本价格是多少？  建站之星下载版如何获取与安装？  浙江网站制作公司有哪些,浙江栢塑信息技术有限公司定制网站做的怎么样？  南阳网站制作公司推荐,小学电子版试卷去哪里找资源好？  免费网站制作模板下载,除了易企秀之外还有什么H5平台可以制作H5长页面，最好是免费的？  定制建站策划方案_专业建站与网站建设方案一站式指南  如何通过服务器快速搭建网站？完整步骤解析  Swift中switch语句区间和元组模式匹配  如何选择高性价比服务器搭建个人网站？  昆明网站制作哪家好,昆明公租房申请网上登录入口？  红河网站制作公司,红河事业单位身份证如何上传？  如何在宝塔面板中创建新站点？  北京网站制作公司哪家好一点,北京租房网站有哪些？  建站主机选哪家性价比最高？  创业网站制作流程,创业网站可靠吗？  建站VPS能否同时实现高效与安全翻墙？  高端企业智能建站程序：SEO优化与响应式模板定制开发  网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏？  c# 在高并发下使用反射发射（Reflection.Emit）的性能  如何在IIS服务器上快速部署高效网站？  阿里云网站搭建费用解析：服务器价格与建站成本优化指南  专业制作网站的公司哪家好,建立一个公司网站的费用.有哪些部分,分别要多少钱？  如何快速生成凡客建站的专业级图册？  制作无缝贴图网站有哪些,3dmax无缝贴图怎么调？  C#如何使用XPathNavigator高效查询XML  建站主机功能解析：服务器选择与快速搭建指南  如何快速生成专业多端适配建站电话？  c++23 std::expected怎么用 c++优雅处理函数错误返回【详解】  湖北网站制作公司有哪些,湖北清能集团官网？  建站168自助建站系统：快速模板定制与SEO优化指南  定制建站模板如何实现SEO优化与智能系统配置？18字教程  如何获取免费开源的自助建站系统源码？  GML (Geography Markup Language)是什么，它如何用XML来表示地理空间信息？  如何通过宝塔面板实现本地网站访问？  制作农业网站的软件,比较好的农业网站推荐一下？  如何在景安服务器上快速搭建个人网站？  制作销售网站教学视频,销售网站有哪些？  测试制作网站有哪些,测试性取向的权威测试或者网站？  如何在云指建站中生成FTP站点？  php json中文编码为null的解决办法  c# 在ASP.NET Core中管理和取消后台任务  如何自定义建站之星网站的导航菜单样式？  建站主机选购指南：核心配置优化与品牌推荐方案  高端建站三要素：定制模板、企业官网与响应式设计优化