CYQ.Data V5 从入门到放弃ORM系列：教程 - MAction类使用

背景：

随着V5框架使用者的快速增加，终于促使我开始对整个框架编写完整的Demo。

上周大概花了一星期的时间，每天写到夜里3点半，终完成了框架所有功能的Demo。

同时，按V5框架名称空间的顺序，对每个类的使用，补充相应的文章介绍，以漏补缺。

以下开始介绍：

MAction Demo的项目文件：

1：项目解决方案：

2：两个文件在Debug目录里：

演示的是SQLite数据库（默认System.Data.SQLite.DLL是64位版本，如果运行提示加载出错，自己解压32位的复盖即可）

demo.db的数据库结构为：（后续的Demo也以此两表为示例）

3：App.Config文件配置的是数据库链接：

本类里面演示的是：单表、多表查询、多表操作，下面一个一个看：

单表操作：

1：界面：

2：代码：

 public partial class 单表操作 : Form
     {
         string tableName = "Users";
         public 单表操作()
         {
             AppConfig.DB.EditTimeFields = "EditTime";//该配置的字段，在更新时会自动被更新时间。
             InitializeComponent();
             Pager.OnPageChanged += Pager_OnPageChanged;
         }
 
         void Pager_OnPageChanged(object sender, EventArgs e)
         {
             LoadData();
         }
 
         private void 单表操作_Load(object sender, EventArgs e)
         {
             LoadData();
 
         }
         private void LoadData()
         {
             MDataTable dt;
             using (MAction action = new MAction(tableName))
             {
                 dt = action.Select(Pager.PageIndex, Pager.PageSize, "order by " + action.Data.PrimaryCell.ColumnName + " desc");
                 OutDebugSql(action.DebugInfo);
             }
             if (dt != null && dt.Rows.Count > )
             {
                 if (txtUserID.Text == "")
                 {
                     dt.Rows[].SetToAll(this);
                 }
             }
             //  dgView.DataSource = dt.ToDataTable();
           //
            dt.Bind(dgView);
             Pager.DrawControl(dt.RecordsAffected);
         }
 
         private void OutDebugSql(string msg)
         {
             if (string.IsNullOrEmpty(msg))
             {
                 msg = "Auto Cache...";//相关的配置，如：AppConfig.Cache.IsAutoCache = false;
             }
             rtxtSql.Text = msg;
         }
 
         private void btnFill_Click(object sender, EventArgs e)
         {
             using (MAction action = new MAction(tableName))
             {
                 if (action.Fill(txtUserID))
                 {
                     action.UI.SetToAll(this);
                     OutDebugSql(action.DebugInfo);
                 }
             }
         }
 
         private void btnInsert_Click(object sender, EventArgs e)
         {
             using (MAction action = new MAction(tableName))
             {
                 if (!action.Exists(txtName))
                 {
                     action.AllowInsertID = chbInsertID.Checked;
                     action.UI.SetAutoParentControl(this);//Web开发的不需要这条
                     if (action.Insert(true, InsertOp.ID))
                     {
                         action.UI.SetToAll(this);
                         LoadData();
                     }
                 }
                 OutDebugSql(action.DebugInfo);
             }
         }
 
         private void btnUpdate_Click(object sender, EventArgs e)
         {
             using (MAction action = new MAction(tableName))
             {
                 action.UI.SetAutoParentControl(this);
                 if (action.Update(true))
                 {
                     LoadData();
                 }
                 OutDebugSql(action.DebugInfo);
             }
         }
 
         private void btnDelete_Click(object sender, EventArgs e)
         {
             using (MAction action = new MAction(tableName))
             {
                 if (action.Delete(txtUserID))
                 {
                     LoadData();
                 }
                 OutDebugSql(action.DebugInfo);
             }
         }
 
         private void btnNoDelete_Click(object sender, EventArgs e)
         {
             AppConfig.DB.DeleteField = "IsDeleted";//演示用代码，一般配置在config对全局起使用。
             btnDelete_Click(sender, e);
             AppConfig.DB.DeleteField = "";
         }
 
         private void btn_Click(object sender, EventArgs e)
         {
             using (MAction action = new MAction(tableName))
             {
                 action.Exists(txtUserID);
                 action.Exists(txtName);//自动推导
                 OutDebugSql(action.DebugInfo);
             }
         }
         private void btnOpenMutipleTable_Click(object sender, EventArgs e)
         {
             多表查询 m = new 多表查询();
             m.Show();
         }
         private void btnMutipleOperator_Click(object sender, EventArgs e)
         {
             多表操作 m = new 多表操作();
             m.Show();
         }
 
     }

3：补充讲解：

1：一开始的设想的Demo是：读数据库表（选择表）=》自动生成表单表=》然后实现上述的所有功能。

2：为了让新手看的容易明白，Demo走常规化，没写的那么自动化。

3：功能包含增删改查，检测存在，分页，排序等功能（事务在多表里演示）。

4：演示Demo中还有两个控件依赖（txtUserID，txtName），这两个也是可以传值的，所以整体是可无硬编码依存的。

多表查询：

1：界面：

2：代码：

  public partial class 多表查询 : Form
     {
         public 多表查询()
         {
             AppDebug.Start();
             InitializeComponent();
         }
         private void OutSql()
         {
             rtxtSql.Text = AppDebug.Info;
             AppDebug.Stop();
             AppDebug.Start();
         }
         private void btnView_Click(object sender, EventArgs e)
         {
             MDataTable dt;
             using (MAction action = new MAction("V_Article"))
             {
                 dt = action.Select();
                 OutSql();
             }
             dt.Bind(dgvView);
         }
 
         private void btnSql_Click(object sender, EventArgs e)
         {
             string sql = "select a.*,u.Name from article a left join users u on a.UserID=u.UserID";
             MDataTable dt;
             using (MAction action = new MAction(sql))
             {
                 dt = action.Select("order by userid desc");
                 OutSql();
             }
             dt.Bind(dgvView);
         }
 
         private void btnJoin_Click(object sender, EventArgs e)
         {
             MDataTable dt;
             using (MAction action = new MAction("Article"))
             {
                 dt = action.Select();
 
             }
             dt.JoinOnName = "UserID";
             dt = dt.Join("Users", "UserID", "Name");
             OutSql();
             dt.Bind(dgvView);
 
         }
     }

3：补充讲解：

有3种方法可以涉及多表

1：数据库里创建视图。

2：自定义SQL语句【原来是视图语句，这里内部自动补充成视图语句，增加小小的用户体验】（不能有排序，排序应放在where中）

3：MDataTable的Join方法（优点是：A：可以跨（不同种类的）数据库；B：可以增加自动缓存的利用率【都是单表操作，内存关联】）

多表操作：

1：界面：

2：代码：

  public partial class 多表操作 : Form
     {
         public 多表操作()
         {
             InitializeComponent();
         }
         private void OutSql(string msg)
         {
             rtxtSql.Text = msg;
         }
         private void LoadData(string where)
         {
             MDataTable dt;
             using (MAction action = new MAction("V_Article"))
             {
                 action.SetSelectColumns("UserID", "Name", "Title", "Content", "PubTime");//设置要显示的列
                 dt = action.Select(, , where);
             }
             dt.Bind(dgvView);
         }
         private void btnTransation_Click(object sender, EventArgs e)
         {
             MDataTable dt = null;
             string guid = Guid.NewGuid().ToString();
             using (MAction action = new MAction("Users"))
             {
                 bool result = false;
                 action.SetTransLevel(IsolationLevel.ReadCommitted);//可设置的事务级别，一般可以不用设置
                 action.BeginTransation();//设置开启事务标识
                 action.Set("Name", guid.Substring(, ));
                 action.Set("Password", "");
                 int id = ;
                 if (action.Insert())//第一个执行时，事务才被加载
                 {
                     id = action.Get<int>();
                     action.ResetTable("Article");
                     action.Set("UserID", id);
                     action.Set("Title", guid.Substring(, ));
                     action.Set("Content", guid.Substring(, ));
                     action.Set("PubTime", DateTime.Now);
                     result = action.Insert(InsertOp.None);
                 }
                 else
                 {
                     action.RollBack();//手工回滚
                 }
                 action.EndTransation();//提交事务
                 if (result)
                 {
                     LoadData("UserID=" + id);
                 }
                 OutSql(action.DebugInfo);
             }
             if (dt != null)
             {
                 dt.Bind(dgvView);
             }
         }
 
         private void 多表操作_Load(object sender, EventArgs e)
         {
             LoadData(null);
         }
 
         private void btnShowInfo_Click(object sender, EventArgs e)
         {
             StringBuilder sb = new StringBuilder();
             MDataTable dt = null;
             using (MAction action = new MAction("Article"))
             {
                 sb.Append("AllowInsertID:");
                 sb.AppendLine(action.AllowInsertID.ToString());
 
                 sb.Append("ConnectionString:");
                 sb.AppendLine(action.ConnectionString);
 
                 sb.Append("DalType:");
                 sb.AppendLine(action.DalType.ToString());
 
                 sb.Append("DalVersion:");
                 sb.AppendLine(action.DalVersion);
 
                 sb.Append("DebugInfo:");
                 sb.AppendLine(action.DebugInfo);
 
                 sb.Append("RecordsAffected:(通常在执行一个命令后，返回受影响的行数)");
                 sb.AppendLine(action.RecordsAffected.ToString());
 
                 sb.Append("TableName:");
                 sb.AppendLine(action.TableName);
 
                 sb.Append("TimeOut:");
                 sb.AppendLine(action.TimeOut.ToString());
 
                 sb.Append("UI对象:");
                 sb.AppendLine(action.UI.ToString());
 
                 dt = action.Data.Columns.ToTable();
             }
             dt.Bind(dgvView);
             rtxtSql.Text = sb.ToString();
         }
 
         private void btnPara_Click(object sender, EventArgs e)
         {
             MDataTable dt;
             using (MAction action = new MAction("Users"))
             {
                 action.SetPara("Name", "0%", DbType.String);
                 dt = action.Select("Name like @Name");
             }
             dt.Bind(dgvView);
         }
     }

3：补充讲解：

1：这里的演示比较单纯，并没有使用单表操作时批量操作（因为是自己造数据，没有界面或外界传值）。

2：一般SQL操作内部有异常，事务是会自动回滚的，只要判断true,false就可以了；

3：如果是自己的代码异常，或业务判断需要回滚，就RollBack()一下。

总结：

1：本次演示，并没有使用框架操作的ProjectTool去生成枚举（后续ORM名称空间的Demo是有生成实体的）：常规项目时，生成枚举，可代替硬编码问题。

2：SVN里对应的Demo示例相对丰富，每个类都有Demo，当然也有个别我偷懒了（直接链接到了文章，哈）。

3：在整个写Demo的一周里，（1：处理偏冷的小问题，少量不常用的方法新增或减少），版本的升级也很频繁，目前稳定在V5.6.3.2版本。

4：Demo的SVN下载地址：https://github.com/cyq1162/cyqdata

5：谢谢支持！