信息化基础建设 窗体开发

窗体开发的主题内容

1. 窗体属性设置

2. CRUD与代码生成

3. 高级选项

4. 设计规范

 

使用EPN框架制作员工主档窗体，效果图如下

 

属性设置

增加窗体，EmployeeMaster

设置继承的类为EntryForm

[FunctionCode("SAISEM")]

public partial class EmployeeMaster : EntryForm

{

     public EmployeeMaster()

   {

     InitializeComponent();

    }

}

并且添加功能编码SAISEM

在EPN的分类设置选项中，设置窗体的EPN属性如下

这表示，窗体支持新增，修改，删除，拷贝，导入/导出，过帐，增加附件，不支持批核(工作流)

拖动一个EntityCollection到窗体中，并设置它的EntityFactoryToUse对象

依照需要展示的数据层次结构，拖动为数个BindingSource到窗体中。

举例：比如要显示采购单头和采购明细信息，需要拖动2个BindingSource，分别显示采购单头和采购明细

对于本例，需要显示员工表的表头信息和文件(Document)信息，则需要拖动2个BindingSource

组件窗口看起来是这样

然后依次设置BindingSource的数据源

设置employeeBindingSource的数据源

设置employeeDocumentBindingSource的数据源

依据需要显示的字段，放窗体中拖放TextEditor,NumberiEditor,Grid,CheckBox

在Visual Studio 2010中，看起来是这样

设置窗体的数据源属性，MainBindingSource和NavigateBindingSource

如果当前窗体要一次性将所有的Entity读入到窗体的GridView，则将Form的MainBindingSource与navigatorBindingSource都设置为employeeBindingSource。

如果窗体打开时只需显示一条Entity，则将窗体的MainBindingSource设为employeeBindingSource，再添加一个新的bindingSource组件，数据源不要选，留空。将其设为窗体的NavigatorBindingSource。

设置窗体主键属性

设置值如下

至此，F5，窗体已经可以运行，在快速启动栏中输入SAISEM，即可启动窗体，如开篇所展示的效果。

 

代码生成

到目前为止，窗体已经可以运行，但并不可以进行数据的读写，我们还要给它新增加数据读写代码。

再引用开发框架中关于库存项目的一张图

BusinessLogic 业务逻辑，业务实体，这个由代码生成器自动生成

Interface 接口 读写数据和业务逻辑的接口

Manager 实现接口 实现接口

System Administration/Inventory, 界面，放入EmployeeMaster窗体

为此，祭出代码生成工具CodeSmith，帮忙我们完成枯燥容易出错的应用框架的代码。

接口文件IEmployeeManager，将生成的文件拷贝到Interface项目中

实现文件EmployeeManager，将生成的文件拷贝到Manager项目中

窗体文件生成,将生成的文件内容拷贝到EmployeeMaster窗体文件中

代码如下

private IEmployeeManager _EmployeeManager = null ;

private EmployeeEntity _Employee = null ;

protected override void OnShown(EventArgs e)

{

base.OnShown(e);

if (!DesignMode)

{

}

}

protected override void OnLoad(EventArgs e)

{

if(!DesignMode)

this._EmployeeManager = ClientProxyFactory.CreateProxyInstance<IEmployeeManager>();

base.OnLoad(e);

}

protected override void InitNavigator(InitNavigatorArgs args)

{

base.InitNavigator(args);

args.SortExpression.Add(EmployeeFields.EmployeeNo | SortOperator.Ascending);

}

protected override EntityBase2 LoadData(Dictionary<string, string> refNo)

{

base.LoadData(refNo);

string employeeNo = string.Empty;

if (refNo.TryGetValue("EmployeeNo", out employeeNo))

{

IPrefetchPath2 prefetchPath = new PrefetchPath2((int)EntityType.EmployeeEntity);

prefetchPath.Add(EmployeeEntity.PrefetchPathEmployeeDocument);

_employee = _employeeManager.GetEmployee(employeeNo, prefetchPath);

}

else

{

_employee = new EmployeeEntity();

}

return _employee;

}

protected override void BindControls(EntityBase2 entity)

{

base.BindControls(entity);

this.employeeBindingSource.DataSource = entity;

}

protected override EntityBase2 Add( )

{

base.Add();

this._Employee = new EmployeeEntity();

return _Employee;

}

protected override EntityBase2 Save(EntityBase2 entityToSave)

{

base.Save(entityToSave);

EmployeeEntity _Employee = (EmployeeEntity)entityToSave;

this._Employee =this._EmployeeManager.SaveEmployee(_Employee);

return _Employee;

}

protected override void Delete(EntityBase2 entityToDelete)

{

base.Delete(entityToDelete);

EmployeeEntity Employee = (EmployeeEntity)entityToDelete;

this._EmployeeManager.DeleteEmployee(Employee);

}

protected override object Clone(Dictionary<string, string> refNo)

{

base.Clone(refNo);

string employeeNo = string.Empty;

refNo.TryGetValue("EmployeeNo", out employeeNo);

if (string.IsNullOrEmpty(employeeNo))

{

using (ILookupForm lookup = EPN.Common.GetLookupForm("EmployeeLookup"))

{

lookup.SetCurrentValue(CurrentRefNo);

if (lookup.ShowDialog() != DialogResult.OK)

return null;

employeeNo = lookup.GetFirstSelectionValue();

}

}

if (!string.IsNullOrEmpty(employeeNo))

{

this._employee = this._employeeManager.CloneEmployee(employeeNo);

return this._employee;

}

return null;

}

protected override void ReleaseResources( )

{

base.ReleaseResources();

try

{

_Employee = null;

_EmployeeManager= null;

}

catch

{

}

}

到此，已经完成了窗体开发的所有内容。

为加入更多的验证逻辑，生成一些验证，放到验证项目中

比如，需要验证身份证号码必须输入，电话号码要符合当地的编号规则，等等，这些逻辑验证，都可以写在这里

 

高级选项

到此为止，几乎是没有敲任何的代码，我们就完成了员工主档的开发，这样的速度，肯定让你吃惊，也开始疑惑：

1. 业务逻辑写在哪里？

比如，当输入员工的出生日期为1983年时，程序应当自动算出员工的年龄为DateTime.Now- DateTime(1983,10,20), 当输入员工的学历为本科时，它在公司的组织架构级别中，就自动对应22B，而不是大专毕业对应的21B。

参考一开始设计的图，程序从一开始就是界面和逻辑分离的，逻辑直接写到BusinessLogical项目中去，也就是代码自动生成的EmployeeEntity文件。

这里有一个小技巧，代码生成器会为我们生成2个EmployeeEntity文件，一个是EmployeeEntity.cs, 另一个是EmployeeEntity.Logical.cs的文件，前一个文件，是依据数据表的字段，自动生成的文件，后一个文件，是存放自定义逻辑的地方，也就是需要放入逻辑的代码文件。

2. 程序界面上的特殊要求，通过以上生成的代码肯定没有做到。

比如，需要给员工主档添加图片显示，如图中，显示James Bond的图片，这个功能需要手动写。

其次，要给物料主档添加条形码支持，将生成的条形码作为物料编码的依据，这个功能也需要手写。

再比如开篇中的那张图片，Employee No.后面的按钮，是用来给员工智能编码用的。一般会依据员工学历，工作经验，专业的不同来产生相应的员工编码。

3. 逻辑和界面严格分离带来的一些问题。

如果要在逻辑里面根据不同的条件，给用户一个提示，这个会相当麻烦。因为逻辑与界面已经严格分离，绝不允许在逻辑中调用MessageBox.Show, 为了阻止这个行为的发生，在逻辑的References中，直接删除了System.Windows.Forms的引用。

同理，在界面中访问逻辑中的部分代码片段也相当麻烦，有时候在界面中也需要直接访问数据库，比如，在做销售送货时，根据当前用户输入的销售单号，判断这个SO是否已经完成送货，如果已经完成送货，则不允许产生送货单，这个逻辑只有在界面上实现，因为在BusinessLogical中Shipment对象还没有产生，无法做判断。

4. 性能 Performance

在把数据从数据库读到界面时，ORM和ADO.NET性能区别不大，但是，在做保存和更新时，ORM会判断当前已经做出修改的数据，仅仅生成这个被修改数据的UPDATE语句，这样的性能提升是很占优势的。

ADO.NET中，更新员工的语句一般是

UPDATE Name=’James Bond’ , Country=’ England’ WHERE EmployeeNo=’007’

很少可能会这样写，为了更新员工的名字，写一个SQL

UPDATE Name=’James Bond’ WHERE EmployeeNo=’007’

更新员工的国籍，于是又写一个SQL

UPDATE Country=’ England’ WHERE EmployeeNo=’007’

ORM框架会很高兴的帮忙我们判断，究竟有哪些数据被修改(dirty),并且只产生这些数据的UPDATE.

 

窗体规范

CodeSmith已经帮忙我们做好了大量的重复代码，也相当规范。

如果仍然要手写代码，遵守共同的规范，会使代码看起来更统一，规范

控件命名规范

控件类型	前缀	举例
Label	lbl	lblMessage
Button	Btn	btnSave
GroupBox	gbx	gbxMain
GridView	grd	grdSalesOrderDetails

仅有这个规范还不行，毕竟遵守起来还是有点困难，EPN框架还运用分词技术，自动为窗体中的控件重命名。

我们的窗体中的控件代码，看起来是这样

private EPN.WinUI.TextEditor txtDeptName;

private EPN.WinUI.Label lblDeptName;

private EPN.WinUI.PictureBox picImage;

private EPN.WinUI.GridView grdSalesOrder;

当为控件绑定属性时，自动为控件重命名。比如，我将TextBox1绑定到数据源EmployeeNo，于是控件被重命名为txtEmployeNo,看控件名称，就可以知道数据源，也知道控件类型，以达到高度的规范统一。

 

窗体的设计标准

1 DialogBox,对话框，一般要能响应ESC和Enter键，也有OK和Cancel2个按钮

2 窗体中控件的Tab order是否合理

3 Short cut key，快键键访问，所有的窗体也需要一致,也不能有冲突。

4 当窗体中需要盛放的数据量较大时，有2种思路

以GroupBox分组，以方便查看

当数据量再增多时，以Tab分组

5 窗体执行时间较长的任务，要使BackgroundWorker,以保证窗体可以接受响应，任务执行完毕后，或用MessageBox.Show显示successfully done,或与VS2010一样，在status bar中显示执行结果.比如在VS2010中成功check in代码后，在status bar中会显示成功签入变更集54498.

同时，cursor也不能放过,像这样写：

this.Cursor=Cursors.WaitCursor;

.....long operation

this.Cursor=Cursors.Default;

6 窗体组织方式，避免MDI forms，推荐tab式 MDI。

必要时，可以这样，把form放到panel中，设置form的TopLevel = false

7 ListView控件，要支持copy，而且可以多行copy

8 Enter和Tab key的作用，都会去下一个tab order的control

9 WinForms程序，最好的可以接受command line的启动方式，这样可以用bat命令启动。而且可以加启动参数。

VS2005、2008，2010都可以从command line启动。还记得常用的deven /resetpackage吗？

10 尽量阻止一台电脑，同时运行程序的两个实例,使用Singletion模式。

11 Target尽量是AnyCPU,而不x86。因为Microsoft Jet Access 数据库没有64bit的版本，宁愿移除对Jet Access的依赖和使用，也不愿把Target改成x86. 自Windows 7以来，64bit的OS已经相当普及，要使自己的程序不会一打开就stop working,就尽量编译成AnyCPU吧。

12 RichTextBox，如果是程序添加内容，需要auto scroll到最行的一行数据。观察VS2010编译的时候，Output窗口

13 对于用户不能修改的数据，不仅要使TextBox为readonly,最好还要使它的背景颜色变成gray，一目了然。

必须输入数据的控件，需要有个统一的提示，像这样

当该控件有值时，右边的红色图片hidden,没有值时，显示图片。这和Ajax中的watermark是相同的原理