讲师中心 微信公众号
AI工具推荐 视频效率加速

Dapper的commandType参数是什么 Dapper CommandType用法详解

胖磊姑娘_6375

胖磊姑娘_6375

发布时间:2025-12-21 09:24:08

|

616人浏览过

|

来源于php中文网

原创

CommandType是Dapper中指定SQL命令类型的枚举,必须显式设为CommandType.StoredProcedure才能正确调用存储过程,否则会报错或输出参数失效;默认CommandType.Text用于普通SQL语句。

dapper的commandtype参数是什么 dapper commandtype用法详解

CommandType 是 Dapper 中用于明确指定 SQL 命令类型的枚举参数,它告诉数据库驱动“你传进来的这段字符串到底该当什么用”——是普通 SQL 语句、存储过程,还是其他类型。不显式指定时,Dapper 默认按 CommandType.Text 处理,也就是当成原始 SQL 字符串执行;但一旦调用存储过程,就必须设为 CommandType.StoredProcedure,否则会报错或行为异常。

什么时候必须显式设置 CommandType

主要出现在以下两类场景:

  • 调用 SQL Server、MySQL 等数据库的存储过程(如 EXEC GetUserById 或 CALL sp_get_order)
  • 使用某些数据库提供程序(如 MySqlConnector)时,即使写的是 SELECT 语句,若底层协议对命令类型敏感,也可能需要显式声明

常见 CommandType 枚举值及对应用法

CommandType.Text(默认值)
用于标准 SQL 查询或 DML 语句,比如 SELECT * FROM Users、INSERT INTO Logs (...) VALUES (...)。Dapper 会原样发送给数据库执行。

CommandType.StoredProcedure
告诉 ADO.NET 这是一个已命名的存储过程,数据库会按过程名查找并执行,参数也按存储过程定义的顺序和方向(input/output/return)处理。例如:

connection.Query("GetUserById", new { Id = 123 }, commandType: CommandType.StoredProcedure);

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载

CommandType.TableDirect(极少用)
直接访问表本身(绕过 SQL 解析),一般只在特定高性能导出场景中出现,Dapper 中基本不用,也不推荐。

不设 CommandType 的典型问题

如果你调用存储过程却没写 commandType: CommandType.StoredProcedure,会发生这些情况:

  • SQL Server:抛出 Invalid object name 'YourStoredProcedure' 错误(把它当成了表或视图)
  • MySQL:可能执行失败,或返回空结果,因为 CALL sp_name() 被当成了普通查询而未被识别
  • 参数方向失效:比如输出参数(ParameterDirection.Output)不会被读取,DynamicParameters.Get() 拿不到值

配合 DynamicParameters 使用的关键细节

用存储过程 + 输出参数时,CommandType.StoredProcedure 和 DynamicParameters 必须搭配使用:

  • 输入参数可简写为匿名对象,但只要涉及 Output 或 ReturnValue,就得用 DynamicParameters
  • 必须在 Execute 或 Query 调用中传入 commandType: CommandType.StoredProcedure,否则输出参数不会生效
  • 示例中漏掉这一项,parameters.Get<int>("@RowCount")</int> 就永远是默认值

基本上就这些。CommandType 不复杂,但容易忽略——尤其从写 SQL 切换到调用存储过程时,加一行 commandType: CommandType.StoredProcedure 就能避开多数运行时错误。

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4583

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

951

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1209

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

6541

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

3303

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

6520

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

8941

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1210

2024.04.29

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

20

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 192人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn