当前位置:

首页 > 编程开发 > C#如何使用SqlSugar_C#国产强类型ORM快速入门【核心】

C#如何使用SqlSugar_C#国产强类型ORM快速入门【核心】

C# 使用 SqlSugar 必须避开的几个“静默坑” SqlSugar 不是那种需要花大量时间配置上下文的ORM,它主打快速落地——配对连接字符串和实体,Queryable 和 Updateable 就能直接跑起来,不用建上下文、不用写迁移脚本、也不用配置映射文件。但快速不代表无脑:有几个关键点一

本文目录

    C# 使用 SqlSugar 必须避开的几个“静默坑”

    SqlSugar 不是那种需要花大量时间配置上下文的ORM,它主打快速落地——配对连接字符串和实体,Queryable 和 Updateable 就能直接跑起来,不用建上下文、不用写迁移脚本、也不用配置映射文件。但快速不代表无脑:有几个关键点一旦忽略,就会在运行时出现静默失败,让你查半天都不知道问题出在哪。

    先说几个核心判断:DbType必须显式指定,不能靠连接字符串自动猜;实体类最好用特性标注清楚,否则表名主键对不上就查不出数据;null判断必须用 == null 或 != null,其他写法可能生成错误的SQL;事务必须通过 Ado.UseTran 统一管理,别以为自己调用 BeginTransaction() 就万事大吉。

    C#如何使用SqlSugar_C#国产强类型ORM快速入门【核心】

    怎么配 ConnectionConfig 才不报 DbType 不匹配

    最常见的错误是配完连接后查不出数据,而且系统不抛任何异常。你打开数据库一看,SQL语句是有的,但结果集永远是空。原因很简单:DbType枚举没有显式指定,或者指定错了。

    • SqlSugar 不会根据连接字符串里的关键字(比如MySQL的 Server=localhost)自动推断数据库类型,你必须手写 DbType.MySql、DbType.SqlServer 等枚举值。
    • 枚举值不能写错:SQL Server用 SqlServer,MySQL用 MySql,SQLite用 Sqlite,PostgreSQL用 PostgreSQL。拼错或用错,比如MySQL连接串配了 DbType.SqlServer,Queryable 可能返回空集合且不报错——这就是静默失败。
    • 国产数据库(达梦、人大金仓)需要额外安装驱动,并且确认 DbType 是否支持。部分版本只能用 DbType.Custom 配合自定义适配器,否则也会静默失败。

    所以,检查一下你的 ConnectionConfig 中 DbType 和 ConnectionString 是不是严格匹配。这是最基础的,但也是最容易翻车的地方。

    实体类不加特性也能查,但为什么一定要加 SugarTable 和 SugarColumn

    不加特性时,SqlSugar 默认用类名当表名、属性名当字段名。表面看省事,实际漏洞不少:

    • 如果数据库表名是 user_info(含下划线),类名写成 UserInfo,默认转换会变成 userinfo,查不到数据。
    • 主键字段不叫 Id 或 ID,比如叫 user_id,不标注 [SugarColumn(IsPrimaryKey = true)] 就无法使用 InSingle 方法获取单条记录。
    • 字段长度、是否为空、默认值等约束全靠运行时推断,CodeFirst.InitTables 建表时可能把字符串全建成 nvarchar(50),跟你的实际需求不符。
    • IsIdentity = true 必须显式标注,否则在事务中插入后拿不到自增ID。

    建议:哪怕只是小项目,也花两分钟把表名和主键特性加上。这点耐心,能省掉后面大量的排查时间。

    Queryable 写 WHERE 条件时,null 判断为什么总失效

    典型现象:代码写 .Where(x => x.Name != null),生成 SQL 却是 WHERE Name NULL(永远为 false)。这其实是 SqlSugar 表达式树解析的一个特殊限制:

    • 必须用 == null 或 != null 这种直接比较,不要用 object.Equals(x.Name, null) 或 string.IsNullOrEmpty(x.Name),后者不会被识别为SQL的 IS NULL / IS NOT NULL。
    • 字符串判空需要写两步:.Where(x => x.Name != null && x.Name != ""),不支持 string.IsNullOrWhiteSpace。
    • 可空类型(如 int?)用 .Where(x => x.Status.HasValue) 是安全的。旧版(v5.1.4之前)用 x.Status != null 可能生成错误的SQL,建议升级。
    • 调试利器:打开 Aop.OnLogExecuting,看实际发出的 SQL 是否包含 IS NULL。如果不是,说明表达式没被正确识别,赶紧换写法。

    事务里用 Updateable 更新失败却不回滚?

    根本原因在于 SqlSugar 的事务控制粒度在 SqlSugarScope 层,而不是每个 Updateable 自动加入当前事务。很多人只调了 BeginTransaction(),但那个只影响 ADO.NET 层,Updateable 会新建连接,导致事务失效。

    • 必须用 Ado.UseTran 显式开启事务,这是正确用法:
    db.Ado.UseTran(() => {
        db.Updateable(entity).ExecuteCommand();
        db.Insertable(other).ExecuteCommand();
    });
    • 如果混用 Ado 原生操作和 Updateable,必须全部放在同一个 UseTran 闭包内。跨闭包的调用不共享事务上下文。
    • IsAutoCloseConnection = true 在事务中必须设为 false,否则每次 ExecuteCommand 后连接会被关闭,事务自然中断。

    最容易被忽略的一点:SqlSugar 的强类型不是靠编译期检查,而是靠运行时解析表达式树。所有 Queryable / Updateable 的 lambda 参数,必须是实体的真实属性路径(比如 x.CreateTime),不能是计算属性、方法调用或局部变量引用,否则静默降级为内存查询或直接抛出 NotSupportedException。这一点在做复杂条件过滤时尤其要小心。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 C#
    相关文章 更多
    winforms教程自学入门与基础开发步骤详解
    winforms教程自学入门与基础开发步骤详解

    本教程详细讲解如何使用Visual Studio创建WinForms项目,通过添加按钮和标签控件并编写点击事件代码,实现一个基础的计数器功能,适合C#初学者快速上手Windows窗体应用开发。

    谈编程与编程语言
    谈编程与编程语言

    编程的本质是创造性的严谨翻译,通过for、if和函数调用实现重复计算任务。语言发展让集成度提高,门槛降低但竞争加剧。程序员需培养整体架构能力,抓住思想精髓而非追逐新技术,方能长远发展。

    什么是面向接口编程、面向过程编程、面向对象编程?
    什么是面向接口编程、面向过程编程、面向对象编程?

    面向接口编程通过接口解耦,降低耦合度并提升可扩展性和维护性,是面向对象思想的精髓。面向过程编程将问题拆解为步骤,用函数依次执行。面向对象编程将事物抽象为对象,封装属性和方法,通过对象协作解决问题。

    我对编程的一些感悟
    我对编程的一些感悟

    编程这件事,说到底是门手艺活,但又不全是手艺。把代码写出来容易,把代码写好、写出境界,那就得看功夫了。今天聊几个核心判断,算是多年敲键盘的一点沉淀。 一、语言是功夫,思路是内功 编程语言五花八门,就像武林高手会的功夫一样,但想成为顶尖高手,内功必须深厚。内功到了,学新功夫就是分分钟的事。看过《倚天屠

    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程
    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程

    abstract类不能被直接实例化,子类必须用override实现其所有抽象方法。抽象类可实现接口,并以抽象方法转发接口成员。抽象类不能与sealed共用,其抽象方法默认隐式virtual且无方法体。可包含字段、属性等非抽象成员。

    c#如何删除文件_c#删除文件的正确用法与注意事项
    c#如何删除文件_c#删除文件的正确用法与注意事项

    C#删除文件前应先判断存在性以防异常,注意权限不足和文件被占用。File.Delete与FileInfo.Delete功能相同,后者适合多次操作。无异步删除方法,推荐后台执行或限流以避免阻塞。

    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点
    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点

    在EmguCV中,进行Bitmap转Image时,需先转为24位无Alpha格式,以避免颜色错乱问题;Image转Bitmap时,建议使用Mat或ImageBox控件,以有效减少内存拷贝;跨线程处理时,应使用Mat.Clone()进行深拷贝,以确保数据安全;DLL加载失败时,需设置x64平台目标,并确保native库在输出目录中。

    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】
    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】

    C#图表生成中,LiveCharts需用ChartValues数据集合,并在更新后触发重绘;OxyPlot饼图需启用交互与标签;包引用务必注意版本适配;导出图片需在布局完成后操作,并校正DPI缩放以确保清晰度。

    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】
    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

    ASP.NETCore过滤器需关注执行顺序、作用域与DI生命周期。接口实现需手动注册,特性继承更常用但需满足构造函数要求。全局注册时注意scoped服务注入问题,Order值须显式设置以控制同类型过滤器执行顺序。异常过滤器仅捕获操作方法内异常,模型绑定与授权失败须分别处理。

    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例
    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例

    实现全局鼠标钩子需使用SetWindowsHookEx配合WH_MOUSE_LL,窗体级事件仅捕获本进程消息。回调函数必须为静态且标记特定签名,禁止阻塞操作。通过Marshal.PtrToStructure解析lParam获取坐标与按键状态。钩子生命周期绑定线程,需注意注册线程持续运行并双重卸载,避免句柄泄漏。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。