如何设计一个编辑窗体的基类

为什么我们需要一个编辑的基类呢?

成都创新互联公司专注为客户提供全方位的互联网综合服务,包含不限于做网站、网站建设、改则网络推广、微信小程序定制开发、改则网络营销、改则企业策划、改则品牌公关、搜索引擎seo、人物专访、企业宣传片、企业代运营等,从售前售中售后,我们都将竭诚为您服务,您的肯定,是我们最大的嘉奖;成都创新互联公司为所有大学生创业者提供改则建站搭建服务,24小时服务热线:18982081108,官方网址:www.cdcxhl.com

我们发现对于编辑窗体而言,它们的工作基本的流程是大同小异,而且编辑窗体中每次都需要增加按键处理、是否有编辑内容未保存等提示,因此我们需要一个基类来把这些基本的事情完成。

下面,我们看看是如何实现这个基类的。

通用界面与基本的流程

通用的界面

我们的编辑界面通常是在一个列表界面中,通过点击添加或者编辑按钮,打开一个编辑窗体,他们通常长成下面的这个样子:

基本的流程

我们总结一下基本的流程是下面这样的:

基类的基本实现

构造函数

 
 
  1. public EditFormBase(){    ModelBound = false;    _skipDefaultProcessCmdKey = false;    AutoRename = true; 
  2.     InitializeComponent();    Activated += EditFormBase_Activated;    StartPosition = FormStartPosition.CenterScreen;} 
  3. public EditFormBase(IListFormBase listFrm)    : this(){    ListForm = listFrm;} 
  4.  
  5. 其要点如下: 
  • ModelBound:在窗体编辑时有效,知识是否加载了数据库中的Model,因为很多时候,我们的控件是有相关联动而产生另外的数据的,有时候在数据绑定的时候并不想要产生这些事件,这个时候这个属性就非常有用。比如收款金额,可能是**体积单价*体积**,但是也可能是录单人员手动输入的,这个时候,我们保存的内容包括:体积单价、体积、收款金额;而编辑的时候,这个自动计算的功能是不需要的。

  • _skipDefaultProcessCmdKey:是否忽略现有的键盘按键的操作。基类中我重写了键盘按键事件,按ESC关闭窗体,按Enter提交表单。

  • AutoRename:是否允许基类自动对窗体进行命名。假设实现类中的Title写为“发货单”,那么,新增时基类自动命名为“新增发货单”;编辑时自动命名为“编辑发货单”。

  • EditFormBase_Activated:在这个事件中才处理Model的绑定,这样可以确保Model的绑定在Form_Load事件之后。

  • IListFormBase listFrm:列表界面接口。这个接口要求列表界面对列表数据进行刷新,这样,我们在编辑和更新时候,就可以同时更新列表的数据了。因此,列表窗体必须实现这个接口。

窗体加载与激活

 
 
  1. ///窗体加载 
  2. private void EditFormBase_Load(object sender, EventArgs e) 
  3. { 
  4.     if (IsEdit) 
  5.     { 
  6.         if (AutoRename) 
  7.             Text = "编辑" + Text; 
  8.     } 
  9.     else 
  10.     { 
  11.         ModelBound = true; 
  12.         if (AutoRename) 
  13.             Text = "添加" + Text; 
  14.     } 
  15. } 
  16. ///窗体激活 
  17. private void EditFormBase_Activated(object sender, EventArgs e) 
  18. { 
  19.     if (!FormLoaded) 
  20.     { 
  21.         if (IsEdit) 
  22.         { 
  23.             BindEntity(); 
  24.             ModelBound = true; 
  25.             AfterBindEntity(); 
  26.         } 
  27.         FormLoaded = true; 
  28.     } 
  29. } 

提交表单

 
 
  1. //提交操作,一般在点击按钮之后触发 
  2. protected void ReadySaveEntity(bool close) 
  3. { 
  4.     if (CheckInput()) 
  5.     { 
  6.         Cursor = Cursors.WaitCursor; 
  7.         string operation = IsEdit ? "编辑" : "添加"; 
  8.         try 
  9.         { 
  10.             if (SaveOrUpdateEntity(IsEdit)) 
  11.             { 
  12.                 MessageBoxHelper.ShowTipsSlide("{0}成功!!!", operation); 
  13.                 RefreshUi(); 
  14.                 if (close) 
  15.                 { 
  16.                     DialogResult = DialogResult.OK; 
  17.                     Close(); 
  18.                 } 
  19.                 else 
  20.                 { 
  21.                     ClearScreen(); 
  22.                 } 
  23.             } 
  24.         } 
  25.         catch (Exception ex) 
  26.         { 
  27.             OnSaveOrUpdateError(ex, operation); 
  28.         } 
  29.         finally 
  30.         { 
  31.             Cursor = Cursors.Default; 
  32.         } 
  33.     } 
  34. } 
  35.  
  36. //实际的提交,是一个虚方法,需要子类实现,没有实现将会弹出警告框 
  37. protected virtual bool SaveOrUpdateEntity(bool isEdit) 
  38. { 
  39.     MessageBoxHelper.ShowTips("没有实现添加或者编辑记录的接口,请与开发人员联系"); 
  40.     return false; 
  41. } 

列表更新与界面清空

 
 
  1. //都是有默认的实现,当然你可以可以自己重写 
  2. protected virtual void RefreshUi() 
  3. { 
  4.     if (ListForm != null) 
  5.     { 
  6.         ListForm.RefreshListView(""); 
  7.     } 
  8.     else 
  9.     { 
  10.         MessageBoxHelper.ShowTips("没有实现刷新界面的接口,请与开发人员联系"); 
  11.     } 
  12. } 

数据绑定、控件验证

 
 
  1. //都是空方法,需要子类实现 
  2. protected virtual void BindEntity() 
  3. { 
  4. } 
  5.  
  6. protected virtual void AfterBindEntity() 
  7. { 
  8.  
  9. } 

使用实例

以下面的界面为例子,我们讲讲如何实现这个编辑窗体

其基本实现步骤如下:

继承基类

 
 
  1. public partial class SendOrderEdit : EditFormBase 
  2. { 
  3. public SendOrderEdit(IListFormBase list) 
  4. : base(list) 
  5. { 
  6. InitializeComponent(); 
  7. } 
  8. } 

 

触发保存并新增、保存并关闭按钮

 
 
  1. //保存并新增 
  2. private void btnSaveAndAdd_Click(object sender, EventArgs e) 
  3. { 
  4.     ReadySaveEntity(false); 
  5.     IsEdit = false; 
  6. } 
  7. //保存并关闭 
  8. private void btnSaveAndClose_Click(object sender, EventArgs e) 
  9. { 
  10.     ReadySaveEntity(true); 
  11. } 

实现基本的操作流程

  • 验证CheckInput

  • 数据绑定BindEntity

  • 提交数据库SaveOrUpdateEntity

  • 清空界面ClearScreen

  • 如果需要控制刷新列表的参数,需要重写刷新方法RefreshUi。

带保存按钮和关闭按钮的基类

为了更简化我们的操作和统一编辑界面,我们同时提供了下面这个编辑窗体基类,是带有保存按钮和关闭按钮的:

它的实现非常简单:

 
 
  1. public partial class BaseFormEditNew : EditFormBase 
  2. { 
  3.     public BaseFormEditNew() 
  4.     { 
  5.         InitializeComponent(); 
  6.     } 
  7.  
  8.     public BaseFormEditNew(IListFormBase list) 
  9.         : base(list) 
  10.     { 
  11.         InitializeComponent(); 
  12.     } 
  13.  
  14.     private void btnCancel_Click(object sender, EventArgs e) 
  15.     { 
  16.         Close(); 
  17.     } 
  18.  
  19.     private void btnSave_Click(object sender, EventArgs e) 
  20.     { 
  21.         ReadySaveEntity(true); 
  22.     } 
  23. } 

分享文章:如何设计一个编辑窗体的基类
本文地址:http://wkslyf.com/article/ccejigj.html