Winform开发框架之通用人员信息管理实现代码介绍
我在上一篇《
Winform开发框架之通用人员信息管理
》随笔中介绍了这个通用人员信息管理的大致实现界面和思路，本篇就其中的实现细节做进一步的分析和共享，希望大家对其中的实现代码进行一个了解，并希望多多提出宝贵意见。通用人员信息管理模块，这个模块其实在很多场合都可能用到，如企业员工管理、科室员工管理等等，这些要求登记人员详细资料及图片等信息的系统模块。
1、项目框架布局
以上几个模块分开是为了适应更多的项目需要，如可能用到WCF模块，那么实体类需要独立引用。但是如果是纯粹的Winform模块，以最少化项目为管理原则，那么就不需要那么多工程了，这样也方便项目的集成引用。虽然我们把基于多数据库支持的逻辑及数据库访问实现，封装到一个WHC.StaffData.Core项目里面，但是如果是Winform的项目应用，我们只需要引用他的代码路径就可以了，这样就保证了一份代码实体，多次外部应用的良好处理。如下所示。
这样的Winform模块整合后，我们在实际集成项目的时候，就很方便，人员管理模块就只有一个WHC.StaffDataDx程序集，不用管理太多关于人员模块的程序DLL了（否则有UI层、BLL层、DAL层、IDAL层、Entity层等等很多项目工程，这样一旦模块分的比较多，几十个就出来了，非常不便于管理）。
以上就是一个集成测试项目用到的相关应用，我们看到，人员管理模块里面只有一个程序集，其他的是人员管理模块用到的其他公用模块，这样比较方便管理，更利于大型项目的集成工作，不同的模块职责不同，维护可能也交由不同的技术人员维护即可，而且最大的优点是所有项目都通用，提高重复利用的效率。
集成测试项目是我们实际集成的参考例子，使用很简单，如下所示。
private void btnAddStaff_Click(objectsender, EventArgs e)
{
FrmEditStaff dlg= newFrmEditStaff();
dlg.ShowDialog();
}private void btnStaffList_Click(objectsender, EventArgs e)
{
FrmStaff dlg= newFrmStaff();
dlg.ShowDialog();
}
2、多数据库支持
整个小项目，是我Winform开发框架的缩影，我的Winform开发框架都基本上遵循一个规则来做各独立模块的开发，都具有多数据库支持的特性，良好的框架布局和高质量的代码特性。
我的传统Winform开发框架的设计图，如下所示。其中界面层UI直接访问BLL层，不需要通过网络，其中公用辅助类库Common层、实体类层可以在各个层中访问，并把常用的权限管理、字典管理封装为组件模块，直接调用，底层则使用工厂方式，来支持各种不同的数据库，其中UI层、BLL层、DAL层、实体层均使用继承类方式实现最良好的封装、最优的代码设计。
当然下面的框架示意图也是适用于这个人员管理模块的了。
实现多数据库支持的框架项目实际代码结构如下所示。
他们几个层之间的关系我在很早介绍框架数据库结构就介绍过，如下所示。
他们几个层之间的关系，具有非常强的继承关系，数据访问层有一个超级基类，抽象于各种数据库的基础上而形成，对于不同的数据库，还有一个一般的基类，用来实现详细化的数据库特性，每个业务类，明确继承关系后，就具有一份非凡的本领（具有几乎所有常用到的各类通用接口），很多时候我们基本不需要写任何和数据库操作的代码了。
3、界面实现
对于界面的设计，一直也希望能比较好的体现出我的设计思想，在整个人员信息管理中，有人员学习情况、履历情况、家庭情况、出国情况、职称情况等，界面基本上比较统一，就是一个列表的管理，常规的管理思路，一般还需要对列表的顺序可以自由调整，这是很常见的功能，因此，这里也引入了一个可以调整顺序的
GridControlDrager
辅助类，这个就是在使用时，用户可以拖动记录到任意的顺序。
实现代码如下所示：
private void StaffResumeControl_Load(objectsender, EventArgs e)
{if (!this.DesignMode)
{
GridControlDrager drager= new GridControlDrager(this.gridControl1);
drager.ProcessDragRow+= newGridControlDrager.ProcessEventHandler(drager_ProcessDragRow);
}
}bool drager_ProcessDragRow(int sourceRowHandle, inttargetRowHandle)
{
DataTable table= this.gridControl1.DataSource asDataTable;if (table != null)
{string sourceID = this.gridView1.GetRowCellValue(sourceRowHandle, "ID").ToString();string targetID = this.gridView1.GetRowCellValue(targetRowHandle, "ID").ToString();bool result = BLLFactory<StaffResume>.Instance.UpdateTwoSeq(sourceID, targetID);if(result)
{
DataRow sourceRow=table.Rows[sourceRowHandle];
DataRow row=table.NewRow();
row.ItemArray=sourceRow.ItemArray;
table.Rows.Remove(sourceRow);
table.Rows.InsertAt(row, targetRowHandle);this.gridControl1.DataSource =table;this.gridView1.FocusedRowHandle =targetRowHandle;
}
}return true;
}
几个模块大致的设计界面如下所示，然后在窗体里面集成就可以了。
运行时刻的界面效果如下所示。
以上还包含了附件的管理，这个模块在之前的
《
Winform开发框架之通用附件管理模块
》有介绍，这里不再赘述了。
4、Word报表导出操作
上篇随笔介绍了Word导出的格式，导出的人员信息表如下所示：
我们看到，里面很多信息是单字段的，有部分是列表的，对于单字段，我们采用在模板中添加标签引用方式，然后替换其中的标签引用的文本实现，如下所示。
#region 通过书签方式替换内容Dictionary<string, string> dictBookMark = new Dictionary<string, string>();//姓名,性别,出生时间,政治面貌,党团时间,民族,籍贯,职务,任职时间,工作时间,最高学历,获学历时间,最高学位,//获学位时间,婚否,职称,职称时间,是否独生子女 StaffInfo staffInfo = BLLFactory<Staff>.Instance.FindByID(ID);if (staffInfo != null)
{
dictBookMark.Add("姓名", staffInfo.Name);
dictBookMark.Add("性别", staffInfo.Sex);
dictBookMark.Add("出生时间", staffInfo.BirthDate.GetDateTimeString("yyyy.MM.dd"));
dictBookMark.Add("政治面貌", staffInfo.Political);
dictBookMark.Add("党团时间", staffInfo.PartyDate.GetDateTimeString("yyyy.MM"));
dictBookMark.Add("民族", staffInfo.Nationality);
dictBookMark.Add("籍贯", staffInfo.NativePlace);
dictBookMark.Add("职务", staffInfo.OfficialRank);
dictBookMark.Add("任职时间", staffInfo.ServingDate.GetDateTimeString("yyyy.MM"));
dictBookMark.Add("工作时间", staffInfo.WorkingDate.GetDateTimeString("yyyy.MM"));
dictBookMark.Add("最高学历", staffInfo.HighestEducation);
dictBookMark.Add("获学历时间", staffInfo.EducationDate.GetDateTimeString("yyyy.MM"));
dictBookMark.Add("最高学位", staffInfo.HighestDegree);
dictBookMark.Add("获学位时间", staffInfo.DegreeDate.GetDateTimeString("yyyy.MM"));
dictBookMark.Add("婚否", staffInfo.MarriageStatus);
dictBookMark.Add("职称", staffInfo.Titles);
dictBookMark.Add("职称时间", staffInfo.TitlesDate.GetDateTimeString("yyyy.MM"));
dictBookMark.Add("是否独生子女", staffInfo.ChildStatus);
StaffAwardInfo awardInfo= BLLFactory<StaffAward>.Instance.FindSingle(condition);if (awardInfo != null)
{
dictBookMark.Add("受奖情况", awardInfo.Note);
}
}
Aspose.Words.Document doc= newAspose.Words.Document(templateFile);foreach (string name indictBookMark.Keys)
{
Aspose.Words.Bookmark bookmark=doc.Range.Bookmarks[name];if (bookmark != null)
{
bookmark.Text=dictBookMark[name];
}
}#endregion
对于列表的内容，我们就要引入Aspose.Word的MailMerge功能了，先在固定模板中插入并定义好相关的域引用，如下所示。
创建一系列的域代码引用后，才能利用Aspose.Word的MailMerge功能。
上图红色部分为对于一个列表必须要创建的域代码，包括TableStart:和TableEnd的标识。
创建好这些后，绑定数据源的操作不算复杂，如下所示。
Aspose.Words.DocumentBuilder builder = newAspose.Words.DocumentBuilder(doc);
List<StaffStudyInfo> studyList = BLLFactory<StaffStudy>.Instance.Find(condition);
DataTable dtStudy= DataTableHelper.ToDataTable<StaffStudyInfo>(studyList);
dtStudy.TableName= "study";
FillStaticRow(dtStudy,5);
List<StaffTitlesInfo> titleList = BLLFactory<StaffTitles>.Instance.Find(condition);
DataTable dtTitle= DataTableHelper.ToDataTable<StaffTitlesInfo>(titleList);
dtTitle.TableName= "title";
FillStaticRow(dtTitle,5);
.....................
DataSet ds = newDataSet();
ds.Tables.Add(dtStudy);
ds.Tables.Add(dtTitle);
ds.Tables.Add(dtResume);
ds.Tables.Add(dtAbroad);
ds.Tables.Add(dtFamily);
doc.MailMerge.ExecuteWithRegions(ds);
doc.Save(saveFile);if (MessageDxUtil.ShowYesNoAndTips("导出成功，是否打开文件？") ==System.Windows.Forms.DialogResult.Yes)
{
Process.Start(saveFile);
}
其中的FillStaticRow函数，我是用来生成固定怎么多行的操作，使得列表默认不少于固定的函数，否则列表不好看。
以上就是我在开发这个模块中的一些经验心得，希望抛砖引玉，对大家有帮助的同时，也能获得更多的反馈意见，相互促进交流。
