Dapper如何处理一对一关系 Dapper一对一查询映射教程

幻夢星雲

发布时间：2025-12-25 15:43:12

802人浏览过

来源于php中文网

原创

Dapper一对一映射需写对SQL、选准splitOn列、写好组装委托；SQL须用别名避免同名列冲突，splitOn填关联对象首列名（如"UserId"），委托中手动赋值并处理null。

dapper如何处理一对一关系 dapper一对一查询映射教程

用Dapper做一对一映射，核心就三点：写对SQL、选对splitOn列、写好组装委托。它不自动推断关系，但控制清晰、性能高，适合明确知道数据结构的场景。

SQL要包含两个表的字段，并注意列名不冲突

必须把主表和关联表的所有需要字段都查出来，推荐用表别名避免同名列覆盖（比如两个表都有Id）：

示例SQL：

SELECT p.Id AS PostId, p.Content, u.Id AS UserId, u.Name AS UserName
  FROM Posts p
  LEFT JOIN Users u ON u.Id = p.OwnerId

这样能确保Dapper按列顺序准确切分数据段。如果不用别名，且两表都有Id，Dapper可能误判分割点。

splitOn参数指定关联对象的起始列

splitOn不是写外键名，而是写“第二个对象字段在结果集里第一次出现的列名”。上例中User对象从UserId列开始，所以设为"UserId"：

如果SQL里写的是u.Id且没别名，那splitOn填"Id"（但容易和p.Id混淆）
如果用了u.Id AS UserId，就填"UserId"——更安全、更明确
大小写敏感，必须和SQL中AS后的名称完全一致

用委托函数把子对象挂到父对象属性上

Query方法返回的是主对象类型，嵌套对象靠你自己在委托里赋值：

Img.Upscaler

免费的AI图片放大工具

下载

var posts = connection.Query(sql,
  (post, user) => {
    post.Owner = user;
    return post;
  },
  splitOn: "UserId"
);

关键细节：

post和user都是Dapper根据splitOn自动创建的实例
LEFT JOIN时user可能是null，建议在赋值前判断：post.Owner = user ?? new User(); 或保留null并用空合并操作符访问：post.Owner?.Name
返回类型写Post，表示最终列表是IEnumerable

实体类得有可写属性，且类型匹配

比如Post类里要有public User Owner { get; set; }，不能是只读属性或私有字段。Dapper只映射public set属性，且不支持自动构造嵌套对象（不会调用new User()）。

如果Owner属性类型和SQL中映射的User不一致（比如写成了object），运行时会抛异常，不是静默失败。

基本上就这些。不复杂但容易忽略别名和splitOn的对应关系。

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

Blazor 发布到 Azure App Service 教程

Dockerfile 中构建 .NET 应用的关键指令有哪些？

c语言编译器app有哪些？

相关标签:

app sql Object NULL select 数据结构 public 委托 var 对象

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

上一篇：C# 协变(Covariance)与逆变(Contravariance) - 泛型中的in和out关键字下一篇：暂无

作者最新文章

得物怎么付款得物支持的支付方式介绍

2025-12-24 13:52

C#如何将Dictionary序列化为XML

2025-12-24 14:06

网易邮箱163登录入口 163邮箱安全登录入口

2025-12-24 14:21

如何用Logstash的XML filter插件解析日志

2025-12-24 14:35

MAUI怎么实现下拉选择框 MAUI Picker控件使用方法

2025-12-24 14:49

C#怎么启动外部程序 C# Process.Start调用exe方法

2025-12-24 14:55

抖音星图平台登录入口官网抖音创作服务平台接单入口

2025-12-24 14:56

Dapper怎么查询数据 Dapper Query方法使用详解

2025-12-24 14:56

Avalonia如何优化列表加载性能 Avalonia UI虚拟化教程

2025-12-24 15:45

EF Core怎么连接SQLite EF Core连接SQLite数据库方法

2025-12-24 16:30

热门AI工具

DeepSeek

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

AI大模型

开放平台

豆包大模型

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

AI大模型

通义千问

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

AI大模型

腾讯元宝

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

文档处理

Excel 表格

文心一言

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

AI大模型

中文写作

讯飞写作

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

中文写作

写作工具

即梦AI

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

图片拼接

图画生成

ChatGPT

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

AI大模型

中文写作

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

AI大模型

PDF 文档

相关专题

数据分析工具有哪些

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

673

2023.10.12