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）。安全写法：

标签： go app ai