Dapper如何处理null值 Dapper数据库null映射C# nullable类型

新闻中心 NEWS CENTER

2025-12-14

浏览次数：次

Dapper自动将数据库NULL映射为C#可空类型（如int?、DateTime?）或引用类型（如string）的null值；若映射到非可空类型（如int）则抛InvalidOperationException异常。

dapper如何处理null值 dapper数据库null映射c# nullable类型

Dapper 会自动将数据库中的 NULL 值映射为 C# 中对应的可空类型（如 int?、DateTime?、string 等），无需额外配置，但需确保实体属性类型与数据库字段语义匹配。

Dapper 按照 .NET 类型系统进行隐式转换：

数据库 NULL → C# 可空值类型（int?、bool?、DateTime?）会被设为 null
数据库 NULL → C# 非可空值类型（int、DateTime）会抛出 InvalidOperationException（“当转换为类型 'Int32' 时，空值无法转换”）
数据库 NULL → C# 引用类型（string、object、自定义类）直接映射为 null

为避免运行时异常，实体属性应与数据库字段的 nullability 保持一致：

数据库列允许 NULL → C# 属性用可空值类型或引用类型（如 public int? Age { get; set; }）
数据库列不允许 NULL → C# 属性可用非可空类型（如 public string Name { get; set; }，注意 string 本身可为 null，但业务上可配合校验）
使用 [Column("xxx")] 或约定命名即可，Dapper 不依赖 DataAnnotations 处理 null 映射

某些情况下需要显式控制 null 行为，例如默认值回退或类型不匹配：

美图AI开放平台

美图推出的AI人脸图像处理平台

111 查看详情美图AI开放平台

查询时用 SQL ISNULL / COALESCE 提前转换（推荐，贴近数据层）：
SELECT Id, ISNULL(Age, 0) AS Age FROM Users

映射后代码中判空处理：

var user = conn.QueryFirstOrDefault<User>("SELECT * FROM Users WHERE Id = @id", new { id });<br>int actualAge = user.Age ?? 18;

使用匿名类型或 ValueTuple 查询时，Dapper 同样遵守类型推导规则：

基本上就这些。只要实体属性类型声明合理，Dapper 的 null 映射是透明且可靠的。

以上就是Dapper如何处理null值 Dapper数据库null映射C# nullable类型的详细内容，更多请关注其它相关文章！