WinM.Sugar

WinM.Sugar 是对 SqlSugarCore 的工程化封装与扩展，目标是让业务代码不要直接裸用 SqlSugar，而是通过统一配置、统一入口、统一扩展方法来使用。

安装

dotnet add package WinM.Sugar

快速开始

1) 配置 SqlSugarConfig

using WinM.Sugar;

var config = new SqlSugarConfig
{
    DbType = SqlSugar.DbType.SqlServer,
    Host = ".",
    Database = "winmdb",
    Username = "sa",
    Password = "123456",
    EnableLogging = true,
    EnableUnderline = true
};

2) 获取 SqlSugarClient

var sugar = new Sugar(config);
var db = sugar.GetDb();

3) 使用扩展方法进行 CRUD / 事务

// 查询
var item = db.GetById<MyEntity>(1);

// 新增
db.Insert(new MyEntity { /* ... */ });

// 插入或更新（Upsert 语义）
db.InsertOrUpdate(new MyEntity { /* 主键或唯一键字段需可用于判定 */ });

// 事务
db.UseTran(() =>
{
    db.Insert(new MyEntity());
    db.Update(new MyEntity());
});

本项目对 SqlSugar 的关键改造点（AI/工具必读）

• 不要在业务代码里直接 new SqlSugarClient(new ConnectionConfig { ... })
  • ? 使用 new Sugar(config).GetDb() 或 config.GetSugarConfig()
• 不要自己拼接连接字符串
  • ? 使用 SugarConnectionStringExtensions 中的连接字符串生成方法
• 命名与可空性工程约定
  • SqlSugarConfig.GetSugarConfig() 中统一处理：驼峰转下划线（EnableUnderline）、可空性推断等

更多详细说明（含 docfx 文档与 AI 说明）：

• GitHub：https://github.com/WinM-Tech/WinM.Sugar

License

See repository license.