17370845950

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

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

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

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

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

注意空结果和 NULL 值处理

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

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

配合参数和异步操作

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

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

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