hisql orm update表数据更新文档

• 2022 年 1 月 12 日
• 筆記
• HiSql

更新

HiSql数据更新

HiSql 提供了好几种数据更新的方式下面一一介绍一下

如果你的表中增加了这四个字段

那么在向表插入数据时HiSql自动会对CreateTime和ModiTime 赋上当前日期，给CreateName和ModiName 赋上连接创建时指定的User的值 （可以将登陆的用户名赋全它），不需要开发人员去赋值。

当更新该表时会自动更新ModiTime 和 ModiName 。

指定主键更新

匿名类数据更新

用匿名类的方式用一个特别好的地方就是你要更新哪些字段就写上哪些字段的值，
但要注意的是匿名内中如果要更新的表有主键那么必须包含主键否则无法更新。

::: tip

实体类的字段列名称要与数据库中对应至少要一个字段要对应不然HiSql将会抛出异常

HiSql允许更新对象列集合大于数据库中的列集合（只取有效的字段）

字段名称忽略大小写
:::

特别注意：以下方式更新不需要带更新条件，因为HiSql会自动识别主键条件

sqlClient.Update("HTest01", new { sid = 123456, UName = "tansar", Age = 25, Salary = 1999.9, Descript = "hello world" }).ExecCommand();

HTest01 中有上面讲到的四个标准字段，虽然没有设置修改日期和修改人 但HiSql底层会自动生成,请看以下生成的SQL代码（SQLSERVER为例)

update [dbo].[HTest01] set [SID]=123456,[UName]='tansar',[Age]=25,[Salary]=1999.9,[Descript]='hello world',[ModiTime]='2022-01-11 20:04:51.725',[ModiName]='Hone' where [SID]=123456

也许一看以上生成的SQL就明白了HiSql的解析原理了字段SID是主键，ModiTime和ModiName 是自动加上去的

匿名类批量更新

通过该方式更新时是生成多条更新语句执行
特别注意：以下方式更新不需要带更新条件，因为HiSql会自动识别主键条件

List<object> lstdata = new List<object>()
{
    new{ sid =123456, UName ="tansar", Age =25, Salary =1999.9, Descript ="hello world"},
    new{ sid =123457, UName ="tansar2", Age =25, Salary =1999.9, Descript ="hello world"}
};

int v=sqlClient.Update("HTest01", lstdata).ExecCommand();

更新指定字段

指定更新字段可以用方法Only(params string[] fields) 如果有多个字估请参数Only("UName","Descript")

sqlClient.Update("HTest01", new { sid = 123456, UName = "tansar", Age = 25, Salary = 1999.9, Descript = "测试只更新此字段" }).Only("Descript").ExecCommand();

根据以上代码只会更新字段 Descript 但该表有标准字段同时也会更新ModiTime和ModiName

生成的SQL如下(sqlserver为例)

update [dbo].[HTest01] set [Descript]='测试只更新此字段',[ModiTime]='2022-01-12 14:13:40.438',[ModiName]='Hone' where [SID]=123456

排除更新字段

指定排除更新字段可以用方法Exclude(params string[] fields) 如果有多个字估请参数Exclude("UName","Descript")

sqlClient.Update("HTest01", new { sid = 123456, UName = "tansar", Age = 25, Salary = 1999.9, Descript = "测试只不更新此字段" }).Exclude("Descript").ExecCommand();

根据以上代码除了字段 Descript 其它的值都会更新， 该表有标准字段同时也会更新ModiTime和ModiName

生成的SQL如下(sqlserver为例)

update [dbo].[HTest01] set [UName]='tansar',[Age]=25,[Salary]=1999.9,[ModiTime]='2022-01-12 14:24:08.624',[ModiName]='Hone' where [SID]=123456

字典更新

字典可以是new Dictionary<string, object> 也可以是new Dictionary<string, string>

var dicobj = new Dictionary<string, object> { { "SID", 123456 }, { "UName", "tansar" }, { "Age", 25 }, { "Salary", 1999.9 }, { "descript", "hello world" } };
sqlClient.Update("HTest01", dicobj).ExecCommand();

生成的SQL如下(sqlserver为例)

update [dbo].[HTest01] set [SID]=123456,[UName]='tansar',[Age]=25,[Salary]=1999.9 where [SID]=123456

批量字典更新

批量字典更新其实与批量匿名类更新使用方式基本一致的

List<Dictionary<string, object>> lstdata = new List<Dictionary<string, object>> {
    new Dictionary<string, object> { { "SID", 123456 }, { "UName", "tansar" }, { "Age", 25 }, { "Salary", 1999.9 }, { "descript", "hello world" } },
    new Dictionary<string, object> { { "SID", 123457 }, { "UName", "tansar" }, { "Age", 25 }, { "Salary", 1999.9 }, { "descript", "hello world" } }
};

sqlClient.Update("HTest01", lstdata).ExecCommand();

::: tip
实体类的更新与匿名类基本是一致的，这里就不重复写了，排除更新和指定更新与匿名类的写法是一模一样也不再重复写样例
:::

按条件更新

通过结构化WHERE更新

关于where 的写法更多的样例请参照hisql ORM 查询语句使用教程文档

int v= sqlClient.Update("HTest01").Set(new { UName = "TEST" }).Where(new Filter { { "SID", OperType.EQ, 123456 } }).ExecCommand(); 

生的成SQL语句如下(sqlserver为例)

update [dbo].[HTest01] set [UName]='TEST',[ModiTime]='2022-01-12 15:10:28.184',[ModiName]='tansar' where [HTest01].[SID] = 123456

通过HiSql语法更新

关于HiSql 的写法更多的样例请参照 hisql ORM 查询语句使用教程文档

int v = sqlClient.Update("HTest01").Set(new { UName = "TEST" }).Where("SID=123456").ExecCommand();

生的成SQL语句如下(sqlserver为例)

update [dbo].[HTest01] set [UName]='TEST',[ModiTime]='2022-01-12 15:15:04.695',[ModiName]='tansar' where [HTest01].[SID] = 123456

字段表达式

平常业务可能会有这种场景将数据库中的某一个字段自长1或加一个指定的值如下例所示

int v = sqlClient.Update("HTest01", new { SID = 123456, Salary = "`Salary`+1" }).ExecCommand();

生的成SQL语句如下(sqlserver为例)

update [dbo].[HTest01] set [SID]=123456,[Salary]=[Salary]+1,[ModiTime]='2022-01-12 15:23:48.626',[ModiName]='Hone' where [SID]=123456