Dapper如何处理SQL Server的hierarchyid类型 Dapper层次数据查询

Dapper不直接支持SQL Server的hierarchyid类型，需通过字符串映射、原生SQL处理或自定义TypeHandler配合Microsoft.SqlServer.Types实现读写与层次查询。

Dapper 本身不直接支持 SQL Server 的 hierarchyid 类型，但可以通过类型映射、自定义转换和原生 SQL 配合实现完整读写与层次查询。

理解 hierarchyid 在 Dapper 中的默认行为

Dapper 默认将 hierarchyid 映射为 byte[] 或 string（取决于数据库驱动返回值），无法直接调用其方法（如 .GetAncestor()、.IsDescendantOf()）。SQL Server 的 hierarchyid 是 CLR UDT 类型，需显式处理。

• 使用 Microsoft.Data.SqlClient（推荐）时，hierarchyid 列默认返回 SqlHierarchyId 实例（需引用 Microsoft.SqlServer.Types）
• 若用 System.Data.SqlClient（已弃用），则通常退化为 byte[]，需手动反序列化（不推荐）
• Dapper 不会自动调用 SqlHierarchyId.Parse() 或 .ToString()，需在代码或 SQL 层转换

读取 hierarchyid：推荐用字符串中间表示

最实用的方式是让 SQL 返回可读的路径字符串（如 /1/2/3/），避免 .NET 端依赖 SQL Server 类型库。

• 查询时用 CONVERT(VARCHAR, hierarchy_column) 或 hierarchy_column.ToString()
• 映射到 C# 的 string 属性，便于日志、前端展示和简单比较
• 示例：

  var nodes = connection.Query<OrgNode>(@"
      SELECT Id, Name, CONVERT(VARCHAR(50), Path) AS PathStr 
      FROM OrgNodes 
      WHERE Path.IsDescendantOf(CONVERT(HIERARCHYID, @root)) = 1",
      new { root = "/1/" });

  登录后复制

写入与层次关系查询：交给 SQL Server 原生处理

层级逻辑（如查找子树、计算层级深度、插入子节点）强烈建议在 SQL 中完成，而非在 C# 中解析 hierarchyid 字节数组。

标签： 前端 node 处理器 app 字节 microsoft sqlserver c# .net