Install-Package SqlSugarCore  # .NET Core/.NET 5+
# 或針對(duì)特定數(shù)據(jù)庫(kù)安裝擴(kuò)展包（如MySQL）
Install-Package MySqlConnector  # MySQL驅(qū)動(dòng)

using SqlSugar;
using System;
?
// 1. 定義連接配置
var config = new ConnectionConfig
{
    ConnectionString = "Server=.;Database=TestDB;Uid=sa;Pwd=123456;", // 連接字符串
    DbType = DbType.SqlServer, // 數(shù)據(jù)庫(kù)類型（如DbType.MySql）
    IsAutoCloseConnection = true, // 自動(dòng)關(guān)閉連接（推薦開啟）
    InitKeyType = InitKeyType.Attribute // 從實(shí)體特性讀取主鍵/自增配置
};
?
// 2. 初始化客戶端（二選一）
// 方式1：SqlSugarClient（非線程安全，每次操作new實(shí)例或通過(guò)IOC注入Scope）
var db = new SqlSugarClient(config);
?
// 方式2：SqlSugarScope（線程安全，適合單例模式，如ASP.NET Core注入）
// var db = new SqlSugarScope(config);

using SqlSugar;
using System;
?
// 映射到數(shù)據(jù)庫(kù)表：Sys_User
[SugarTable("Sys_User")]
public class User
{
    // 主鍵（自增）
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
?
    // 用戶名（字段名：User_Name，長(zhǎng)度50，非空）
    [SugarColumn(ColumnName = "User_Name", Length = 50, IsNullable = false)]
    public string UserName { get; set; }
?
    // 密碼（字段名：User_Pwd，加密存儲(chǔ)）
    [SugarColumn(ColumnName = "User_Pwd", Length = 100)]
    public string Password { get; set; }
?
    // 年齡（默認(rèn)值0）
    [SugarColumn(DefaultValue = "0")]
    public int Age { get; set; }
?
    // 注冊(cè)時(shí)間（默認(rèn)值：當(dāng)前時(shí)間）
    [SugarColumn(ColumnName = "Reg_Time", DefaultValue = "GETDATE()")]
    public DateTime RegTime { get; set; }
?
    // 忽略字段（不映射到數(shù)據(jù)庫(kù)）
    [SugarColumn(IsIgnore = true)]
    public string TempData { get; set; }
}

// 單條新增
var user = new User 
{ 
    UserName = "張三", 
    Password = "123456", 
    Age = 25 
};
// 執(zhí)行新增并返回自增ID
int newId = db.Insertable(user).ExecuteReturnIdentity(); 
?
// 批量新增（性能優(yōu)于循環(huán)單條插入）
var userList = new List<User>
{
    new User{ UserName = "李四", Password = "654321", Age = 30 },
    new User{ UserName = "王五", Password = "abc123", Age = 28 }
};
bool isSuccess = db.Insertable(userList).ExecuteCommand() > 0; // 返回影響行數(shù)

// 2.1 單條查詢（根據(jù)條件）
User user = db.Queryable<User>()
              .Where(u => u.UserName == "張三") // 條件
              .First(); // 返回第一條
?
// 2.2 列表查詢（帶排序）
List<User> users = db.Queryable<User>()
                     .Where(u => u.Age > 25) // 年齡>25
                     .OrderBy(u => u.RegTime, OrderByType.Desc) // 按注冊(cè)時(shí)間倒序
                     .ToList(); // 返回列表
?
// 2.3 分頁(yè)查詢（第2頁(yè)，每頁(yè)10條）
int pageIndex = 2;
int pageSize = 10;
var pageResult = db.Queryable<User>()
                   .ToPageList(pageIndex, pageSize, out int totalCount); 
// totalCount：總記錄數(shù)（用于分頁(yè)控件）
?
// 2.4 聚合查詢（統(tǒng)計(jì)、求和等）
int total = db.Queryable<User>().Count(); // 總記錄數(shù)
int maxAge = db.Queryable<User>().Max(u => u.Age); // 最大年齡
decimal avgAge = db.Queryable<User>().Average(u => u.Age); // 平均年齡

// 3.1 全量更新（根據(jù)主鍵）
user.Age = 26; // 修改年齡
bool updateSuccess = db.Updateable(user).ExecuteCommand() > 0;
?
// 3.2 局部更新（只更新指定字段，性能更優(yōu)）
bool partialUpdate = db.Updateable<User>()
                       .SetColumns(u => u.Age == 27) // 只更新Age字段
                       .Where(u => u.UserName == "張三") // 條件
                       .ExecuteCommand() > 0;

// 4.1 根據(jù)實(shí)體刪除（根據(jù)主鍵）
bool deleteByEntity = db.Deleteable(user).ExecuteCommand() > 0;
?
// 4.2 根據(jù)條件刪除
bool deleteByWhere = db.Deleteable<User>()
                       .Where(u => u.Age < 18) // 刪除年齡<18的用戶
                       .ExecuteCommand() > 0;

// 查詢“注冊(cè)時(shí)間在最近30天”且“年齡>平均年齡”的用戶
var subQuery = db.Queryable<User>().Select(u => SqlFunc.AggregateAverage(u.Age)); // 子查詢：平均年齡
?
var result = db.Queryable<User>()
               .Where(u => u.RegTime >= DateTime.Now.AddDays(-30) 
                        && u.Age > subQuery) // 關(guān)聯(lián)子查詢
               .ToList();

// 訂單實(shí)體（含導(dǎo)航屬性）
[SugarTable("Orders")]
public class Order
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public int UserId { get; set; } // 外鍵（關(guān)聯(lián)User.Id）
    // 導(dǎo)航屬性：關(guān)聯(lián)用戶（一對(duì)一）
    [Navigate(NavigateType.OneToOne, nameof(UserId))] 
    public User User { get; set; } 
}
// 查詢訂單時(shí)同時(shí)加載關(guān)聯(lián)的用戶信息
var orders = db.Queryable<Order>()
               .Includes(o => o.User) // 加載導(dǎo)航屬性
               .Where(o => o.Id > 100)
               .ToList();
// 使用關(guān)聯(lián)數(shù)據(jù)
foreach (var order in orders)
{
    Console.WriteLine($"訂單ID：{order.Id}，用戶名：{order.User.UserName}");
}

try
{
    // 開啟事務(wù)
    db.Ado.BeginTran();
    // 執(zhí)行多個(gè)操作（新增用戶+新增訂單）
    var newUser = new User { UserName = "趙六", Password = "111", Age = 35 };
    int userId = db.Insertable(newUser).ExecuteReturnIdentity();
    var newOrder = new Order { UserId = userId, OrderNo = "ORD_123" };
    db.Insertable(newOrder).ExecuteCommand();
    // 提交事務(wù)
    db.Ado.CommitTran();
}
catch (Exception ex)
{
    // 回滾事務(wù)
    db.Ado.RollbackTran();
    Console.WriteLine($"事務(wù)失?。簕ex.Message}");
}