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(@"
      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 字节数组。

• 插入新节点：用 GetDescendant(NULL, NULL) 或 GetReparentedValue() 生成路径
• 查所有后代：用 WHERE Path.IsDescendantOf(@parent) = 1
• 查直接子节点：加 AND Path.GetLevel() = @parentLevel + 1
• Dapper 只负责传参和映射，不参与 hierarchyid 运算

高级场景：映射到 SqlHierarchyId 并封装操作

若需在 .NET 中构造或验证 hierarchyid（如后台批量生成树），可引入 Microsoft.SqlServer.Types 并注册自定义类型处理器。

• 安装 NuGet：Microsoft.SqlServer.Types
• 注册 Dapper 类型处理器（一次）：

  Dapper.SqlMapper.AddTypeHandler(typeof(SqlHierarchyId), 
      new SqlHierarchyIdTypeHandler());

• 自定义 handler 示例：将 string → SqlHierarchyId.Parse()，反之调用 .ToString()
• 注意：部署时需确保目标服务器有对应 SQL Server CLR 类型运行时（Azure SQL 托管实例支持，普通 Azure SQL DB 不支持）

基本上就这些。核心原则是——把 hierarchyid 当作 SQL Server 的“黑盒路径类型”来用，Dapper 负责安全传参和结果映射，真正的树形逻辑留在 T-SQL 里执行，既高效又可靠。