在Winform开发中,我们往往除了常规的单表信息录入外,有时候设计到多个主从表的数据显示、编辑等界面,单表的信息一般就是控件和对象实体一一对应,然后调用API保存即可,主从表就需要另外特殊处理,本随笔介绍如何快速实现主从表编辑界面的处理,结合GridControl控件的GridView控件对象,实现数据在列表中的实时编辑,非常方便。
主从表一般涉及两个以上的表,一个是主表,其他的是从表的,在实际情况下,一般包含两个表较多,我们这里以两个表的主从表关系进行分析处理。
例如我们建立两个报销申请单表关系如下所示。
对于报销的主从表信息,我们可以在列表中进行展示,如下界面所示,分为两部分:一部分是主表信息,一部分是从表信息,单击主表信息后,显示对应从表的列表信息。
那么我们新增一条主表记录的时候,那么可以弹出一个新的界面进行数据的维护处理,方便我们录入主从表的信息,界面如下所示。
上面界面包括了主表信息,以及从表的信息(在GridView中实时录入)两部分,这样填写后统一进行提交处理。
这里主要介绍一下主从表的编辑界面处理,也就是上面这个界面的实现处理。
其中初始化GridView的代码如下所示。
/// <summary> /// 初始化明细表的GridView数据显示 /// </summary> private void InitDetailGrid() { //初始清空列 this.gridView1.Columns.Clear(); //设置部分列隐藏 this.gridView1.CreateColumn("ID", "编号").Visible = false; this.gridView1.CreateColumn("Header_ID", "主表编号").Visible = false; this.gridView1.CreateColumn("Apply_ID", "申请单编号").Visible = false; //添加下拉列表列,并绑定数据源 this.gridView1.CreateColumn("FeeType", "费用类型", 100).CreateComboBox().BindDictItems("费用类型"); //创建日期列并指定格式 var OccurTime = this.gridView1.CreateColumn("OccurTime", "发生时间", 120).CreateDateEdit(); OccurTime.EditMask = "yyyy-MM-dd HH:mm"; OccurTime.DisplayFormat.FormatString = "yyyy-MM-dd HH:mm"; //创建数值列 this.gridView1.CreateColumn("FeeAmount", "费用金额").CreateSpinEdit(); //创建备注列 this.gridView1.CreateColumn("FeeDescription", "费用说明", 200).CreateMemoEdit(); //初始化GridView,可以新增列 this.gridView1.InitGridView(GridType.NewItem, false, EditorShowMode.MouseDownFocused, ""); //转义列内容显示 this.gridView1.CustomColumnDisplayText += new CustomColumnDisplayTextEventHandler(gridView1_CustomColumnDisplayText); //处理单元格的样式 this.gridView1.RowCellStyle += new RowCellStyleEventHandler(gridView1_RowCellStyle); //不允许头部排序 this.gridView1.OptionsCustomization.AllowSort = false; //绘制序号 this.gridView1.CustomDrawRowIndicator += (s, e) => { if (e.Info.IsRowIndicator && e.RowHandle >= 0) { e.Info.DisplayText = (e.RowHandle + 1).ToString(); } }; //对输入单元格进行非空校验 this.gridView1.ValidateRow += delegate(object sender, ValidateRowEventArgs e) { var result = gridControl1.ValidateRowNull(e, new string[] { "FeeType" }); }; //新增行的内容初始化 this.gridView1.InitNewRow += (s, e) => { gridView1.SetRowCellValue(e.RowHandle, "ID", Guid.NewGuid().ToString()); gridView1.SetRowCellValue(e.RowHandle, "Header_ID", tempInfo.ID); gridView1.SetRowCellValue(e.RowHandle, "Apply_ID", tempInfo.Apply_ID); gridView1.SetRowCellValue(e.RowHandle, "OccurTime", DateTime.Now); }; } void gridView1_RowCellStyle(object sender, DevExpress.XtraGrid.Views.Grid.RowCellStyleEventArgs e) { GridView gridView = this.gridView1; if (e.Column.FieldName == "FeeAmount") { e.Appearance.BackColor = Color.Green; e.Appearance.BackColor2 = Color.LightCyan; } } void gridView1_CustomColumnDisplayText(object sender, DevExpress.XtraGrid.Views.Base.CustomColumnDisplayTextEventArgs e) { string columnName = e.Column.FieldName; if (e.Column.ColumnType == typeof(DateTime)) { if (e.Value != null) { if (e.Value == DBNull.Value || Convert.ToDateTime(e.Value) <= Convert.ToDateTime("1900-1-1")) { e.DisplayText = ""; } else { e.DisplayText = Convert.ToDateTime(e.Value).ToString("yyyy-MM-dd HH:mm");//yyyy-MM-dd } } } }
上面代码都有详细的备注,主要就是我们根据数据库表的关系,创建对应显示的字段即可,其中有需要隐藏的那么就不要显示(方便获取对应的值)
//设置部分列隐藏 this.gridView1.CreateColumn("ID", "编号").Visible = false; this.gridView1.CreateColumn("Header_ID", "主表编号").Visible = false; this.gridView1.CreateColumn("Apply_ID", "申请单编号").Visible = false;
如果需要绑定下拉列表类似的字段,那么创建对应的数据类型,然后调用绑定函数绑定即可,如下面代码
//添加下拉列表列,并绑定数据源 this.gridView1.CreateColumn("FeeType", "费用类型", 100).CreateComboBox().BindDictItems("费用类型");
如果是一些特殊的输入需要设置格式显示或者掩码,那么如下所示
//创建日期列并指定格式 var OccurTime = this.gridView1.CreateColumn("OccurTime", "发生时间", 120).CreateDateEdit(); OccurTime.EditMask = "yyyy-MM-dd HH:mm"; OccurTime.DisplayFormat.FormatString = "yyyy-MM-dd HH:mm";
另外有一个值得注意的就是我们新增一行从表记录的时候,需要记录一些主表的属性,这样的话,我们就是在行初始化的时候,赋值给从表的隐藏列即可。
//新增行的内容初始化 this.gridView1.InitNewRow += (s, e) => { gridView1.SetRowCellValue(e.RowHandle, "ID", Guid.NewGuid().ToString()); gridView1.SetRowCellValue(e.RowHandle, "Header_ID", tempInfo.ID); gridView1.SetRowCellValue(e.RowHandle, "Apply_ID", tempInfo.Apply_ID); gridView1.SetRowCellValue(e.RowHandle, "OccurTime", DateTime.Now); };
在界面中如果我们需要显示主表的信息,那么就根据条件获取对应的主表记录对象,然后显示给界面控件即可。
/// <summary> /// 显示常规的对象内容 /// </summary> /// <param name="info"></param> private void DisplayInfo(ReimbursementInfo info) { tempInfo = info;//重新给临时对象赋值,使之指向存在的记录对象 txtCategory.Text = info.Category; txtReason.Text = info.Reason; txtTotalAmount.Value = info.TotalAmount; txtNote.Text = info.Note; }
而保存的时候,我们把界面内容重新赋值给对应的主表对象。
/// <summary> /// 编辑或者保存状态下取值函数 /// </summary> /// <param name="info"></param> private void SetInfo(ReimbursementInfo info) { info.Category = txtCategory.Text; info.Reason = txtReason.Text; info.TotalAmount = txtTotalAmount.Value; info.Note = txtNote.Text; info.ApplyDate = DateTime.Now; info.ApplyDept = base.LoginUserInfo.DeptId; info.CurrentLoginUserId = base.LoginUserInfo.ID; }
而我们需要获取GridView明细输入的时候,就通过一个函数遍历获取GridView的行记录,转换为相应的对象即可,如下所示。
/// <summary> /// 获取明细列表 /// </summary> /// <returns></returns> private List<ReimbursementDetailInfo> GetDetailList() { var list = new List<ReimbursementDetailInfo>(); for (int i = 0; i < this.gridView1.RowCount; i++) { var detailInfo = gridView1.GetRow(i) as ReimbursementDetailInfo; if (detailInfo != null) { list.Add(detailInfo); } } return list; }
这样处理完这些信息后,我们就可以在主表保存的时候,同时保存明细表信息即可。
/// <summary> /// 新增状态下的数据保存 /// </summary> /// <returns></returns> public override bool SaveAddNew() { ReimbursementInfo info = tempInfo;//必须使用存在的局部变量,因为部分信息可能被附件使用 SetInfo(info); info.Creator = base.LoginUserInfo.ID; info.CreateTime = DateTime.Now; try { #region 新增数据 bool succeed = BLLFactory<Reimbursement>.Instance.Insert(info); if (succeed) { //可添加其他关联操作 var list = GetDetailList(); foreach(var detailInfo in list) { BLLFactory<ReimbursementDetail>.Instance.InsertUpdate(detailInfo, detailInfo.ID); } return true; } #endregion } catch (Exception ex) { LogTextHelper.Error(ex); MessageDxUtil.ShowError(ex.Message); } return false; }
其中代码
BLLFactory<ReimbursementDetail>.Instance.InsertUpdate(detailInfo, detailInfo.ID);
可以对新增记录保存,也可以对存在的记录进行更新。
通过上面的介绍,我们可以看到不同的主从表其实逻辑还是很通用的,我们可以把它们的逻辑抽取出来,通过代码生成工具进行快速生成即可。