前一章讲解了如何配置DbSession，本章重点讲解利用MySoft.Data进行数据的插入操作
这里先引用一下上一章的DbSession的配置代码
DbSession配置 /// <summary>
/// 数据库访问类
/// </summary>
public static class DataAccess
{
/// <summary>
/// 通过配置节来实例化DbSession
/// </summary>
public static readonly DbSession DefaultSession = new DbSession("DataExample");
/// <summary>
/// 通过自定义类来实例化DbSession
/// </summary>
public static readonly DataExample ExampleSession = new DataExample();
}
/// <summary>
/// DataExample会话类
/// </summary>
public class DataExample : DbSession
{
public DataExample()
: base("DataExample")
{
#if DEBUG
this.RegisterSqlLogger(log =>
{
System.IO.File.WriteAllText("c:\\log.txt", log);
});
#endif
}
/// <summary>
/// 插入实体
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="item"></param>
/// <returns></returns>
public int Insert<T>(T item) where T : Entity
{
item.Detach();
return base.Save(item);
}
/// <summary>
/// 更新实体
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="item"></param>
/// <returns></returns>
public int Update<T>(T item) where T : Entity
{
item.Attach();
return base.Save(item);
}
}
针对上一节DbSession的配置，可以看到，这里对DataExample类扩展了两个方法，而在我的组件内部并没有Insert<T>(T item)与Update<T>(T item)方法，而是将其合并到了一个方法Save<T>(T item)，外部通过item.Attach()与item.Detach()来改变实体的状态。
注：item.Attach()与item.Detach()方法还有更多强大的用法，下面会重点讲到！
也许有人会觉得合并在一起很难区分插入与修改，应该直接用方法名来区分比较好，当然OK，直接在这里加上两个方法即可，还可以扩展出更多的方法来适应你项目开发的需求，比如你完全可以扩展出一个保存多个对象的方法，如下：
一次插入多条数据的扩展 /// <summary>
/// 一次插入多条数据
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="items"></param>
/// <returns></returns>
public int Insert<T>(IList<T> items) where T : Entity
{
int ret = 0;
foreach (T item in items)
{
ret += Insert(item);
}
return ret;
}
用方法名来区分固然也是好的，但如果需要保存一个实体列表，而这个列表中的实体有些是需要插入的，有些是需要更新的，你该如何处理，只有一种办法，把列表拆分为两个，分别来进行插入与更新。
而使用一个方法Save<T>(T item)可以很方便解决这个问题，在外部将需要插入的方法调用item.Detach(),需要更新的实体调用item.Attach()即可，然后一次传入内部进行操作，还可以为每个实体设置插入的字段或更新的字段！这样是否使用上更优雅一些呢，如下：
Detach()方法的简单应用 Products product = new Products()
{
ProductName = "测试产品1"
};
DataAccess.ExampleSession.Save(product);
product.Detach(Products._.UnitPrice);
DataAccess.ExampleSession.Save(product);
如果数据库中的某些字段有默认值，比如日期字段需要保存为getdate()，就可以通过Detach()方法将其字段移除而不进行插入！
好了，DbSession的方法扩展和简单应用就讲到这里，下面开始讲解如何使用DbSession来插入数据，领略MySoft.Data带给你强大的功能体验与快速开发的便捷吧！
以下操作都以数据库Northwind为例。
一、强类型数据插入
准备工作：
新建一个MySoftExample.DataEntity的项目，使用工具将Northwind中的所有表生成实体，生成的结果如图，生成时将命名空间也设置为MySoftExample.DataEntity。
生成以上实体项目后，再新建一个MySoftExample.Web项目，将MySoftExample.DataEntity项目添加到当前项目的引用中，下面就可以通过生成的实体进行数据的操作了。
下面的操作以Products实体为例进行操作：
1、单个实体数据插入
插入单个对象 //实例化一个Products对象
Products product = new Products()
{
ProductName = "测试产品1"
};
//插入单个对象
DataAccess.ExampleSession.Save(product);
2、批量实体数据插入
插入一组对象 //实例化一组Products对象
List<Products> list = new List<Products>();
for (int index = 0; index < 10; index++)
{
list.Add(new Products()
{
ProductName = "测试产品" + index
});
}
//批量保存数据
DbBatch batch = DataAccess.ExampleSession.BeginBatch(10);
list.ForEach(item =>
{
batch.Save(item);
});
batch.Process();
3、带事务单个实体插入(MySoft.Data内置实现DbTrans)
插入单个对象(内置事务) //实例化一个Products对象
Products product = new Products()
{
ProductName = "测试产品1"
};
//使用事务进行数据插入
using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
{
try
{
trans.Save(product);
trans.Commit();
}
catch
{
trans.Rollback();
}
}
4、带事务批量实体插入(MySoft.Data内置实现DbTrans)
插入一组对象(内置事务) //实例化一组Products对象
List<Products> list = new List<Products>();
for (int index = 0; index < 10; index++)
{
list.Add(new Products()
{
ProductName = "测试产品" + index
});
}
//使用事务进行批量数据插入
using (DbTrans trans = DataAccess.ExampleSession.BeginTrans())
{
try
{
DbBatch batch = trans.BeginBatch(10);
list.ForEach(item =>
{
batch.Save(item);
});
batch.Process();
trans.Commit();
}
catch
{
trans.Rollback();
}
}
5、创建外部数据库链接方式插入
插入单个对象(外部链接) //实例化一个Products对象
Products product = new Products()
{
ProductName = "测试产品1"
};
using (System.Data.Common.DbConnection conn = DataAccess.ExampleSession.CreateConnection())
{
//插入单个对象
DataAccess.ExampleSession.SetConnection(conn).Save(product);
}
注：批量插入可以采用同样的方法处理！
6、创建外部数据库事务方式插入
插入单个对象(外部事务) //实例化一个Products对象
Products product = new Products()
{
ProductName = "测试产品1"
};
using (System.Data.Common.DbTransaction trans = DataAccess.ExampleSession.BeginTransaction())
{
try
{
//插入单个对象
DataAccess.ExampleSession.SetTransaction(trans).Save(product);
trans.Commit();
}
catch
{
trans.Rollback();
}
}
注：批量插入可以采用同样的方法处理！
item.Detach()方法的高级用法
1、指定某些字段使用数据默认值(不改变原有对象传入的状态)
//插入时排除某些字段
Detach(params Field[] removeFields);
//字段CategoryID不进行插入操作
product.Detach(Products._.CategoryID);
//ExcludeField插入时包括的字段
//调用Field.All或Products._.All的Remove方法排除插入的字段可以返回ExcludeField
//也就是说Detach会排除除Remove以外的所有字段
Detach(ExcludeField field);
//只插入ProductName字段
product.Detach(Field.All.Remove(Products._.ProductName));
说明一下：
不改变原有对象的传状态是指，假如product对象已经在外面调用过如：
在之前调用了product.Detach(Product._.SupplierID);
此处再次调用会在原有的基础上再排除CategoryID，相当于SupplierID与CategoryID都不进行插入操作，而以下DetachAll()方法则是清除之前所有的状态，再进行当前的处理。
2、指定某些字段使用数据默认值(改变原有对象传入的状态)
//插入时排除某些字段
DetachAll(params Field[] removeFields);
//字段CategoryID不进行插入操作
product.DetachAll(Products._.CategoryID);
//ExcludeField插入时包括的字段
//调用Field.All或Products._.All的Remove方法排除插入的字段可以返回ExcludeField
//也就是说DetachAll会排除除Remove以外的所有字段
DetachAll(ExcludeField field);
//只插入ProductName字段
product.DetachAll(Field.All.Remove(Products._.ProductName));
InsertOrUpdate方法的使用
当用户不知道当前实体是否在数据库中存在时，可以使用此方法。
内部将会根据主键去判断此实体在数据库中是否存在，然后再自动调用相应的方法来进行处理。
代码 Products product = new Products()
{
ProductID = 1,
ProductName = "测试产品"
};
DataAccess.ExampleSession.InsertOrUpdate(product);
当然数据插入操作还有其它的方式(自己可以慢慢研究)：
代码 DataAccess.ExampleSession.Insert<Products>(
new Field[] { Products._.ProductName },
new object[] { "测试产品" });
int productID;
DataAccess.ExampleSession.Insert<Products, int>(
new Field[] { Products._.ProductName },
new object[] { "测试产品" }, out productID);
二、InsertCreator数据插入
通过插入创建器同样也可以达到上面的效果，也可以进行泛型方式进行数据插入，一般情况下创建器用于没有建立对象实体时直接对表和字段的操作。
1、通过实体插入实体
代码 InsertCreator ic = InsertCreator.NewCreator()
.From<Products>()
.SetEntity<Products>(product);
DataAccess.ExampleSession.Excute(ic);
2、通过字符串表与字段插入数据
代码 InsertCreator ic = InsertCreator.NewCreator()
.From("Products")
.AddInsert("ProductName", "测试产品");
DataAccess.ExampleSession.Excute(ic);
3、通过字符串表与字段插入数据并返回标识列值
代码 InsertCreator ic = InsertCreator.NewCreator()
.From("Products")
.AddInsert("ProductName", "测试产品")
.SetIdentityField("ProductID");
int productID;
DataAccess.ExampleSession.Excute(ic, out productID);
以上通过创建器的方式同样可以用事务来操作 trans.Excute(ic);
这里只是简单的介绍了一下，还有更多的功能需要用户使用时才能体会到。
数据的插入操作就讲解到这里，下一章将讲解数据的修改(Update)操作
有什么问题可以到此处：MySoft组件问题反馈与疑难解答
