Dapper的ExecuteScalar怎么用 Dapper返回单个值教程

Dapper 的 ExecuteScalar 用于执行 SQL 查询并返回结果集第一行第一列的值，适合获取 COUNT、SUM、MAX 等单值；需注意类型匹配、NULL 处理及使用泛型方法或可空类型避免异常。

Dapper 的 ExecuteScalar 用于执行 SQL 查询并返回结果集第一行第一列的值，适合获取 COUNT、SUM、MAX、单个字段等场景。 它不返回对象或列表，只取一个原始值（如 int、string、DateTime、Guid 等），用法简洁但需注意类型匹配和空值处理。

基本用法：查总数、取ID、拿最小值

ExecuteScalar 默认返回 object，建议用泛型方法 ExecuteScalar<t>()</t> 直接获取指定类型，避免手动转换：

• 查记录数：int count = conn.ExecuteScalar<int>("SELECT COUNT(*) FROM Users WHERE Status = @status", new { status = 1 });</int>
• 取最新插入ID（SQL Server）：int newId = conn.ExecuteScalar<int>("INSERT INTO Users (Name) VALUES (@name); SELECT CAST(SCOPE_IDENTITY() as int);", new { name = "张三" });</int>
• 查最大编号：string maxCode = conn.ExecuteScalar<string>("SELECT MAX(Code) FROM Products");</string>

注意空结果和 NULL 值处理

如果查询没返回任何行（比如 WHERE 条件不匹配），ExecuteScalar 返回 null（引用类型）或引发异常（值类型如 int）。安全写法：

Tanka

具备AI长期记忆的下一代团队协作沟通工具

146

查看详情

• 用可空类型接收：int? id = conn.ExecuteScalar<int>("SELECT Id FROM Users WHERE Email = @email", new { email = "x@y.z" });</int>
• 数据库字段可能为 NULL？确保 SQL 中用 ISNULL 或 COALESCE 提供默认值：conn.ExecuteScalar<int>("SELECT COALESCE(MAX(SortOrder), 0) FROM Categories")</int>

配合参数和异步操作

支持匿名对象、DynamicParameters 和异步调用：

• 用 DynamicParameters 更灵活传参：var p = new DynamicParameters(); p.Add("@minAge", 18, DbType.Int32); var avg = conn.ExecuteScalar<decimal>("SELECT AVG(Score) FROM Students WHERE Age >= @minAge", p);</decimal>
• 异步版本：int count = await conn.ExecuteScalarAsync<int>("SELECT COUNT(*) FROM Logs WHERE CreatedAt > @since", new { since = DateTime.Today });</int>

基本上就这些。记住核心：它只拿“第一个值”，别指望它返回一行或多行；类型要对得上，NULL 要兜得住；有异步需求就用 ExecuteScalarAsync。

以上就是Dapper的ExecuteScalar怎么用 Dapper返回单个值教程的详细内容，更多请关注php中文网其它相关文章！