Dapper怎么处理自定义SQL类型 Dapper UDT映射方法_网络技术

Dapper怎么处理自定义SQL类型 Dapper UDT映射方法

发布时间 - 2026-01-03 00:00:00 点击率：次

Dapper通过自定义ITypeHandler实现SQL Server UDT双向映射：SetValue序列化.NET实例为byte[]并设UdtTypeName，Parse反序列化byte[]为UDT实例；需注册处理器、确保UDT类符合序列化规范，并注意类型匹配与空值处理。

Dapper 本身不直接支持 SQL Server 的用户定义类型（UDT），但可以通过自定义 ITypeHandler 实现 UDT 的双向映射——即 .NET 类型 ↔ 数据库 UDT 值。

注册UDT类型处理器

SQL Server 的 UDT（如 Point、Geometry 或自定义 CLR 类型）需在数据库中已注册，并在 .NET 端有对应类（通常实现 INullable 和 IBinarySerialize）。Dapper 依靠 ITypeHandler 完成转换：

SetValue：把 .NET UDT 实例序列化为 SqlBytes 或 byte[]，并设置 parameter.UdtTypeName
Parse：从数据库返回的 SqlBytes 或 object 反序列化为 UDT 实例

示例（以自定义 UDT MyUdt 为例）：

public class MyUdtHandler : SqlMapper.ITypeHandler
{
    public void SetValue(IDbDataParameter parameter, object value)
    {
        parameter.Value = value == null ? DBNull.Value : ((MyUdt)value).ToBinary();
        parameter.UdtTypeName = "dbo.MyUdt"; // 必须与数据库中注册名一致
    }

    public object Parse(Type destinationType, object value)
    {
        if (value == null || value == DBNull.Value) return null;
        var bytes = (byte[])value;
        return MyUdt.FromBinary(bytes);
    }
}

注册方式：

SqlMapper.AddTypeHandler(typeof(MyUdt), new MyUdtHandler());

确保UDT类符合SQL Server要求

.NET 端 UDT 类必须满足 SQL Server 的序列化规范，典型结构包括：

标记 [Serializable] 和 [SqlUserDefinedType(Format.Native)]（或 Format.UserDefined + IBinarySerialize 实现）
提供静态 Parse() 和实例 ToBinary() 方法
无参构造函数（用于反序列化）

若使用 Format.UserDefined，必须完整实现 IBinarySerialize.Read() 和 Write()。

配合Dapper.Contrib或QueryMultiple使用注意事项

UDT 字段在查询中默认无法自动映射到实体属性，除非：

该属性类型与注册的 ITypeHandler 类型完全匹配（含可空性，如 MyUdt? 需额外注册）
避免在 Query() 中混用未映射字段；建议显式 SELECT 所需列，或用匿名类型过渡
插入/更新时，确保参数对象中 UDT 属性值非 null 或已正确处理 null 场景（如设为 DBNull.Value）

替代方案：用内置类型绕过UDT（适用简单场景）

如果 UDT 仅用于封装简单数据（如坐标字符串、编码后的结构），更轻量的做法是：

数据库层仍用 UDT 列，但 Dapper 层统一按 string 或 byte[] 处理
注册 string → MyUdt 的转换器（在业务逻辑中解析），而非让 Dapper 直接持有 UDT 类型
这样可规避 UDT 部署依赖，也便于跨数据库兼容

基本上就这些。关键不是“能不能”，而是“谁负责序列化”——Dapper 把控制权交给你，你只需守住 SetValue 和 Parse 这两个入口。

# 处理器 # 编码 # app # .net # sql # String # Object # NULL # 封装 # 构造函数 # select # format # 字符串 # 对象 # 数据库 # 自定义 # 序列化 # 数据库中 # 只需 # 设为 # 并在 # 所需 # 这两个 # 可以通过 # 为例

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：Word中如何在□里打√？插入特殊符号法【一学就会】

下一篇：VSCode的REST Book：像写代码一样管理API请求

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：Word中如何在□里打√？插入特殊符号法【一学就会】

下一篇：VSCode的REST Book：像写代码一样管理API请求