Dapper的splitOn参数支持多个吗 Dapper多重splitOn用法

幻夢星雲

发布时间：2026-01-31 08:26:02

670人浏览过

来源于php中文网

原创

Dapper的splitOn支持用英文逗号分隔多个列名，用于多级嵌套映射；如查询返回OrderId,OrderNo,CustomerId,CustomerName,AddressId,Street，需写splitOn:"CustomerId,AddressId"以正确分割Order、Customer、Address三个对象。

dapper的spliton参数支持多个吗 dapper多重spliton用法

Dapper 的 splitOn 参数支持多个列名，用英文逗号分隔即可，比如 splitOn: "OrderId,ProductId"。这不是“多次 splitOn”，而是一次指定多个分割点，用于多级嵌套映射（如一查三：Order → Customer → Address）或一对多场景中区分不同实体的起始字段。

什么时候需要多个 splitOn

当 SQL 查询返回三张及以上表的扁平化结果（例如 JOIN 了 Order、Customer、Address），且各实体主键列名不统一（比如不是都叫 Id）时，Dapper 需要明确知道每个新对象从哪一列开始。这时就靠多个列名告诉它：“这里切一刀，开始映射下一个对象”。

第一个对象（如 Order）取 splitOn 之前的所有列
第二个对象（如 Customer）从第一个 splitOn 列（如 CustomerId）开始，到下一个 splitOn 列前为止
第三个对象（如 Address）从第二个 splitOn 列（如 AddressId）开始，取剩余所有列

正确写法示例

假设查询返回：OrderId, OrderNo, CustomerId, CustomerName, AddressId, Street

你想映射为 Order → Customer → Address：

知鹿匠

知鹿匠教师AI工具，新课标教案_AI课件PPT_作业批改

下载

var result = conn.Query(
    sql,
    (order, customer, address) =>
    {
        order.Customer = customer;
        customer.Address = address;
        return order;
    },
    splitOn: "CustomerId,AddressId" // 关键：两个分割点
);

常见误区提醒

不要重复写多个 splitOn 参数：Dapper 只接受一个 splitOn: 参数，值是字符串，不是数组或多个键值对
顺序必须和泛型参数顺序一致：泛型是，那 splitOn 中第一个列对应 T2 起始，第二个列对应 T3 起始
列名必须真实存在于 SELECT 结果中，且大小写需匹配（取决于数据库配置，建议显式别名）
如果某关联记录为空（如 Customer 为 NULL），Dapper 仍能正常映射，但你要在委托函数里判空，避免 NullReferenceException

一对多场景下不直接靠 splitOn 解决

splitOn 本身只处理“一对一”或“线性嵌套”，不能自动展开集合（如一个 Order 对应多个 OrderItem）。要做一对多，得配合 Dictionary 手动归组，或者改用 QueryMultiple 分步查——这时候 splitOn 就只用一次，甚至不用。

基本上就这些。

Blazor Server 与 WASM 混合部署模式教程

MAUI生命周期事件怎么处理 MAUI App生命周期教程

MAUI App Theming怎么用 MAUI动态主题切换

.NET怎么部署到Azure App Service C#应用发布到Azure教程

Blazor 发布到 Azure App Service 教程

相关标签:

app 键值对 sql NULL select 字符串 int 委托泛型对象数据库

本站声明：本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn

上一篇：MAUI如何使用原生Android XML布局 MAUI集成Android布局下一篇：c# C#中的内存序（Memory Order）是什么意思

作者最新文章

微信怎么修改别人发的图片文字微信自带编辑器改字

2026-01-31 10:15

C# HTTP/3支持方法 C#如何在Kestrel和HttpClient中启用HTTP/3

2026-01-31 10:44

上班摸鱼必备MCJS 隐藏游戏入口点开就玩

2026-01-31 10:58

vivo V25屏幕黑屏无法开机 vivo V25强制重启解决方法

2026-01-31 11:01

Pixiv官网登录入口 P站网页版直接访问地址

2026-01-31 11:14

Watchdog库是什么如何用Python监控文件夹变化并上传XML

2026-01-31 11:21

EDI X12标准与XML之间的映射怎么做？

2026-01-31 11:29

小红书创作者平台电脑版官方后台入口

2026-01-31 11:30

电子税务局怎么更正申报数据电子税务局申报错误修改操作方法【指南】

2026-01-31 11:43

CAD看图王怎么批量打印 CAD看图王多图快速打印教程【干货】

2026-01-31 11:50

热门AI工具

DeepSeek

幻方量化公司旗下的开源大模型平台

AI 编程开发 AI 聊天问答

豆包大模型

字节跳动自主研发的一系列大型语言模型

AI 编程开发 AI大模型

通义千问

阿里巴巴推出的全能AI助手

AI 编程开发 Agent智能体

腾讯元宝

腾讯混元平台推出的AI助手

文档处理 AI 聊天问答

文心一言

文心一言是百度开发的AI聊天机器人，通过对话可以生成各种形式的内容。

AI 编程开发 AI 文本写作

讯飞写作

基于讯飞星火大模型的AI写作工具，可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

AI 文本写作中文写作

即梦AI

一站式AI创作平台，免费AI图片和视频生成。

图片拼接

ChatGPT

最最强大的AI聊天机器人程序，ChatGPT不单是聊天机器人，还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

AI 编程开发 AI 文本写作

智谱清言 - 免费全能的AI助手

AI 编程开发 Agent智能体

相关专题

数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍：1、Excel，具有强大的计算和数据处理功能；2、SQL，可以进行数据查询、过滤、排序、聚合等操作；3、Python，拥有丰富的数据分析库；4、R，拥有丰富的统计分析库和图形库；5、Tableau，提供了直观易用的用户界面等等。

751

2023.10.12