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

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

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);

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

不设 CommandType 的典型问题

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

标签： mysql app sql语句 .net red