背景：

随着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：代码：

1 public partial class 单表操作 : Form  2     {  3         string tableName = "Users";  4         public 单表操作()  5         {  6             AppConfig.DB.EditTimeFields = "EditTime";//该配置的字段，在更新时会自动被更新时间。  7             InitializeComponent();  8             Pager.OnPageChanged += Pager_OnPageChanged;  9         } 10  11         void Pager_OnPageChanged(object sender, EventArgs e) 12         { 13             LoadData(); 14         } 15  16  17  18         private void 单表操作_Load(object sender, EventArgs e) 19         { 20             LoadData(); 21  22         } 23         private void LoadData() 24         { 25             MDataTable dt; 26             using (MAction action = new MAction(tableName)) 27             { 28                 dt = action.Select(Pager.PageIndex, Pager.PageSize, "order by " + action.Data.PrimaryCell.ColumnName + " desc"); 29                 OutDebugSql(action.DebugInfo); 30             } 31             if (dt != null && dt.Rows.Count > 0) 32             { 33                 if (txtUserID.Text == "") 34                 { 35                     dt.Rows[0].SetToAll(this); 36                 } 37             } 38             //  dgView.DataSource = dt.ToDataTable(); 39           //  40            dt.Bind(dgView); 41             Pager.DrawControl(dt.RecordsAffected); 42         } 43  44         private void OutDebugSql(string msg) 45         { 46             if (string.IsNullOrEmpty(msg)) 47             { 48                 msg = "Auto Cache...";//相关的配置，如：AppConfig.Cache.IsAutoCache = false; 49             } 50             rtxtSql.Text = msg; 51         } 52  53         private void btnFill_Click(object sender, EventArgs e) 54         { 55             using (MAction action = new MAction(tableName)) 56             { 57                 if (action.Fill(txtUserID)) 58                 { 59                     action.UI.SetToAll(this); 60                     OutDebugSql(action.DebugInfo); 61                 } 62             } 63         } 64  65         private void btnInsert_Click(object sender, EventArgs e) 66         { 67             using (MAction action = new MAction(tableName)) 68             { 69                 if (!action.Exists(txtName)) 70                 { 71                     action.AllowInsertID = chbInsertID.Checked; 72                     action.UI.SetAutoParentControl(this);//Web开发的不需要这条 73                     if (action.Insert(true, InsertOp.ID)) 74                     { 75                         action.UI.SetToAll(this); 76                         LoadData(); 77                     } 78                 } 79                 OutDebugSql(action.DebugInfo); 80             } 81         } 82  83         private void btnUpdate_Click(object sender, EventArgs e) 84         { 85             using (MAction action = new MAction(tableName)) 86             { 87                 action.UI.SetAutoParentControl(this); 88                 if (action.Update(true)) 89                 { 90                     LoadData(); 91                 } 92                 OutDebugSql(action.DebugInfo); 93             } 94         } 95  96         private void btnDelete_Click(object sender, EventArgs e) 97         { 98             using (MAction action = new MAction(tableName)) 99             {100                 if (action.Delete(txtUserID))101                 {102                     LoadData();103                 }104                 OutDebugSql(action.DebugInfo);105             }106         }107 108         private void btnNoDelete_Click(object sender, EventArgs e)109         {110             AppConfig.DB.DeleteField = "IsDeleted";//演示用代码，一般配置在config对全局起使用。111             btnDelete_Click(sender, e);112             AppConfig.DB.DeleteField = "";113         }114 115 116 117         private void btn_Click(object sender, EventArgs e)118         {119             using (MAction action = new MAction(tableName))120             {121                 action.Exists(txtUserID);122                 action.Exists(txtName);//自动推导123                 OutDebugSql(action.DebugInfo);124             }125         }126         private void btnOpenMutipleTable_Click(object sender, EventArgs e)127         {128             多表查询 m = new 多表查询();129             m.Show();130         }131         private void btnMutipleOperator_Click(object sender, EventArgs e)132         {133             多表操作 m = new 多表操作();134             m.Show();135         }136 137     }

3：补充讲解：

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

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

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

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

多表查询：

1：界面：

2：代码：

1  public partial class 多表查询 : Form 2     { 3         public 多表查询() 4         { 5             AppDebug.Start(); 6             InitializeComponent(); 7         } 8         private void OutSql() 9         {10             rtxtSql.Text = AppDebug.Info;11             AppDebug.Stop();12             AppDebug.Start();13         }14         private void btnView_Click(object sender, EventArgs e)15         {16             MDataTable dt;17             using (MAction action = new MAction("V_Article"))18             {19                 dt = action.Select();20                 OutSql();21             }22             dt.Bind(dgvView);23         }24 25         private void btnSql_Click(object sender, EventArgs e)26         {27             string sql = "select a.*,u.Name from article a left join users u on a.UserID=u.UserID";28             MDataTable dt;29             using (MAction action = new MAction(sql))30             {31                 dt = action.Select("order by userid desc");32                 OutSql();33             }34             dt.Bind(dgvView);35         }36 37         private void btnJoin_Click(object sender, EventArgs e)38         {39             MDataTable dt;40             using (MAction action = new MAction("Article"))41             {42                 dt = action.Select();43 44             }45             dt.JoinOnName = "UserID";46             dt = dt.Join("Users", "UserID", "Name");47             OutSql();48             dt.Bind(dgvView);49 50         }51     }

3：补充讲解：

有3种方法可以涉及多表

1：数据库里创建视图。

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

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

多表操作：

1：界面：

2：代码：

1  public partial class 多表操作 : Form  2     {  3         public 多表操作()  4         {  5             InitializeComponent();  6         }  7         private void OutSql(string msg)  8         {  9             rtxtSql.Text = msg; 10         } 11         private void LoadData(string where) 12         { 13             MDataTable dt; 14             using (MAction action = new MAction("V_Article")) 15             { 16                 action.SetSelectColumns("UserID", "Name", "Title", "Content", "PubTime");//设置要显示的列 17                 dt = action.Select(1, 100, where); 18             } 19             dt.Bind(dgvView); 20         } 21         private void btnTransation_Click(object sender, EventArgs e) 22         { 23             MDataTable dt = null; 24             string guid = Guid.NewGuid().ToString(); 25             using (MAction action = new MAction("Users")) 26             { 27                 bool result = false; 28                 action.SetTransLevel(IsolationLevel.ReadCommitted);//可设置的事务级别，一般可以不用设置 29                 action.BeginTransation();//设置开启事务标识 30                 action.Set("Name", guid.Substring(1, 5)); 31                 action.Set("Password", "123456"); 32                 int id = 0; 33                 if (action.Insert())//第一个执行时，事务才被加载 34                 { 35                     id = action.Get(0); 36                     action.ResetTable("Article"); 37                     action.Set("UserID", id); 38                     action.Set("Title", guid.Substring(3, 5)); 39                     action.Set("Content", guid.Substring(5, 5)); 40                     action.Set("PubTime", DateTime.Now); 41                     result = action.Insert(InsertOp.None); 42                 } 43                 else 44                 { 45                     action.RollBack();//手工回滚 46                 } 47                 action.EndTransation();//提交事务 48                 if (result) 49                 { 50                     LoadData("UserID=" + id); 51                 } 52                 OutSql(action.DebugInfo); 53             } 54             if (dt != null) 55             { 56                 dt.Bind(dgvView); 57             } 58         } 59  60         private void 多表操作_Load(object sender, EventArgs e) 61         { 62             LoadData(null); 63         } 64  65         private void btnShowInfo_Click(object sender, EventArgs e) 66         { 67             StringBuilder sb = new StringBuilder(); 68             MDataTable dt = null; 69             using (MAction action = new MAction("Article")) 70             { 71                 sb.Append("AllowInsertID:"); 72                 sb.AppendLine(action.AllowInsertID.ToString()); 73  74                 sb.Append("ConnectionString:"); 75                 sb.AppendLine(action.ConnectionString); 76  77                 sb.Append("DalType:"); 78                 sb.AppendLine(action.DalType.ToString()); 79  80                 sb.Append("DalVersion:"); 81                 sb.AppendLine(action.DalVersion); 82  83                 sb.Append("DebugInfo:"); 84                 sb.AppendLine(action.DebugInfo); 85  86                 sb.Append("RecordsAffected:(通常在执行一个命令后，返回受影响的行数)"); 87                 sb.AppendLine(action.RecordsAffected.ToString()); 88  89                 sb.Append("TableName:"); 90                 sb.AppendLine(action.TableName); 91  92                 sb.Append("TimeOut:"); 93                 sb.AppendLine(action.TimeOut.ToString()); 94  95                 sb.Append("UI对象:"); 96                 sb.AppendLine(action.UI.ToString()); 97  98                 dt = action.Data.Columns.ToTable(); 99             }100             dt.Bind(dgvView);101             rtxtSql.Text = sb.ToString();102         }103 104         private void btnPara_Click(object sender, EventArgs e)105         {106             MDataTable dt;107             using (MAction action = new MAction("Users"))108             {109                 action.SetPara("Name", "0%", DbType.String);110                 dt = action.Select("Name like @Name");111             }112             dt.Bind(dgvView);113         }114     }

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下载地址：http://code.taobao.org/svn/cyqopen/trunk/CYQ.Data.GettingStarted/

5：谢谢支持！