最近一直忙于公司的事情，虽然一直在做一些相关的技术研究，但是很久没能静下心来好好写写博客文章了，想想也有半个月之多了，这半个月来，也一直致力于改善我的WInform开发框架，使得自己及客户使用起来更加方便，更加友好，更加高效。本篇文章就是介绍最近框架改善的其中一个闪光点"通用高级查询模块"，高级查询模块，在很多程序模块中都很常见，也是给客户扩展查询的一个很好的补充，由于我一直希望我的Winform开发框架能够精益求精，所以做了这个模块，希望对今后我自己所有的项目以及框架本身，都能高效的使用。
1、通用高级查询模块的用途及介绍
既然称之为通用查询模块，那么他就不能与具体的表字段有耦合关系，但是要实现具体的查询，必须通过某种方式进行属性传递，实现更直观友好的字段查询功能。高级查询模块，在很多完善的程序上都会提供，用于满足用户对特定的字段，添加特定的条件进行，因为一般情况下，由于版面的限制界面上查询的内容比较有限，只是把一些很常见、重要的字段作为查询输入，如果表字段比较多，那么对有些特殊的字段就无所适从。
例如，我一个病人资料管理系统的界面如下所示
这个界面已经放置的比较多输入控件进行查询了，如果放置更多，超过3行就会导致感觉比较臃肿了。所以合理的应该是把不常用的放到高级查询里面，这样用户需要更多条件的定制，可以在高级查询中对每个字段都能进行搜索，常规的在主界面即可查询。
我的高级查询查询模块也是基于这个道理，因此，在主界面增加一个高级查询按钮入口，如上图所示，单击后，显示一个所有字段的列表，如下界面。
这样所有表的字段均可进行查询了，但是我们注意到，这个界面并没有输入条件的地方，没错，这个只是显示条件内容，浮在主界面的查询列表上面，如果设置条件后，主界面的列表会根据高级查询条件进行查询，这样也是符合客户实际的期望的。
在介绍输入条件的时候，我们注意到，查询输入，基本上可以分为几类：其一是常规的文本类型，使用文本框替代即可；其二是下拉列表类型，用户从列表下面选择内容；其三是日期类型，需要用户指定开始日期和结束日期；其四是数字类型，需要用户指定起始和结束的数值。
刚才说到，上面的高级查询界面，只是显示，但用户双击列表或者按下回车键，那么根据字段类型，弹出对应上面说到的四种输入框，用于接收用户的输入。
1）常规的文本类型条件输入界面：
下拉列表类型条件输入界面：
日期类型条件输入界面：
数字类型条件输入界面：
输入以上几种条件后，高级查询界面里面会显示友好的条件内容，确保用户能够看懂输入的条件，如下所示是输入几个不同类型的条件的显示内容。
日期类型和数字类型，为了方便，都可以单独输入其中的一部分作为条件进行高级查询。
为了方便，高级查询模块的内容，可以进行查询后在主界面列表中显示，也可以使用传统的查询按钮进行查询，使用传统查询按钮后，高级查询条件将失效，但是保留用户的输入，第二次打开界面后，会加载之前的输入条件，这样比较人性化一些，用户可以随时自由切换两种查询方式。
对于一些字段多的历史资料表，这种高级查询模式更加能够发挥其作用，用户可以在几十个甚至上百个字段中选择合适的条件，然后输入进行查询，这样能够使得客户更加有认同感，例如下面是一个病人历史档案资料表的高级查询界面，里面很多字段，使用这个扩展查询就是最合适不过了。
2、通用高级查询模块的实现思路
1）获取数据库字段名称和类型列表
首先前面说到，我是根据字段类型进行不同的控件显示并输入的，因此需要一个通用的函数获取字段的名称和类型，作为参考，由于这个功能比较通用，因此把它放在我的Winform开发框架的数据库基类的抽象类里面，所有的数据库访问类均继承不用重复写代码。
/// <summary>
/// 获取表的字段名称和数据类型列表。
/// </summary>
/// <returns></returns>
public DataTable GetFieldTypeList()
{
DataTable dt = DataTableHelper.CreateTable("ColumnName,DataType");
DataTable schemaTable = GetReaderSchema(tableName);
if (schemaTable != null)
{
foreach (DataRow dr in schemaTable.Rows)
{
string columnName = dr["ColumnName"].ToString().ToUpper();
string netType = dr["DataType"].ToString().ToLower();
DataRow row = dt.NewRow();
row["ColumnName"] = columnName;
row["DataType"] = netType;
dt.Rows.Add(row);
}
}
return dt;
}
/// <summary>
/// 获取指定表的元数据，包括字段名称、类型等等
/// </summary>
/// <param name="tableName">数据库表名</param>
/// <returns></returns>
private DataTable GetReaderSchema(string tableName)
{
DataTable schemaTable = null;
string sql = string.Format("Select * FROM {0}", tableName);
Database db = CreateDatabase();
DbCommand command = db.GetSqlStringCommand(sql);
try
{
using (IDataReader reader = db.ExecuteReader(command))
{
schemaTable = reader.GetSchemaTable();
}
}
catch (Exception ex)
{
LogTextHelper.Error(ex);
}
return schemaTable;
}
2）设置高级查询的字段显示（有时候可能需要过滤部分字段）
3）指定下拉列表的数据内容
刚才说到，有一些下拉列表字段的输入，那么下拉列表也就需要指定里面的列表内容了，高级查询模块，指定下拉列表的代码如下所示。
dlg.AddColumnListItem("MidVideo", GetFieldListItem("MidVideo"));
dlg.AddColumnListItem("InDiagnosis", GetFieldListItem("InDiagnosis"));
dlg.AddColumnListItem("DirectorSurgeon", GetFieldListItem("DirectorSurgeon"));
dlg.AddColumnListItem("TumorPart", GetFieldListItem("TumorPart"));
dlg.AddColumnListItem("LeaveDiagnosis", GetFieldListItem("LeaveDiagnosis"));
dlg.AddColumnListItem("IsFirstTime", GetFieldListItem("IsFirstTime"));
dlg.AddColumnListItem("Professor", GetFieldListItem("Professor"));
对于一些固定的列表项目，我们也可以通过下面代码进行绑定。
dlg.AddColumnListItem("Sex", new List<CListItem>() { new CListItem("男"), new CListItem("女") });
dlg.AddColumnListItem("HasReferral", new List<CListItem>() { new CListItem("是"), new CListItem("否") });
4）和普通查询功能并存
为了使得传统查询按钮，和高级查询能够并存，我们需要存储一个高级查询的查询对象，但传统查询的时候，我们把高级查询对象设置为空即可屏蔽高级查询的条件了。
/// <summary>
/// 高级查询条件语句对象
/// </summary>
private SearchCondition advanceCondition;
/// <summary>
/// 根据查询条件构造查询语句
/// </summary>
private string GetConditionSql()
{
//如果存在高级查询对象信息，则使用高级查询条件，否则使用主表条件查询
SearchCondition condition = advanceCondition;
if (condition == null)
{
condition = new SearchCondition();
condition.AddCondition("BedNo", this.txtBedNo.Text.Trim(), SqlOperator.Like);
condition.AddCondition("TumorPart", this.txtTumorPart.Text.Trim(), SqlOperator.Like);
condition.AddCondition("MidVideo", this.txtMidVideo.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Name", this.txtName.Text.Trim(), SqlOperator.Like);
condition.AddCondition("HospitalNo", this.txtHospitalNo.Text.Trim(), SqlOperator.Like);
condition.AddCondition("IDNumber", this.txtIDNumber.Text.Trim(), SqlOperator.Like);
condition.AddCondition("InDiagnosis", this.txtInDiagnosis.Text.Trim(), SqlOperator.Like);
condition.AddCondition("LeaveDiagnosis", this.txtLeaveDiagnosis.Text.Trim(), SqlOperator.Like);
condition.AddCondition("LeaveSpecimens", this.txtLeaveSpecimens.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Professor", this.txtProfessor.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Note", this.txtNote.Text.Trim(), SqlOperator.Like);
condition.AddCondition("Pathology", this.txtPathology.Text.Trim(), SqlOperator.Like);
condition.AddCondition("IsFirstTime", this.txtIsFirstTime.Text.Trim(), SqlOperator.Like);
..................
}
string where = condition.BuildConditionSql().Replace("Where", "");
return where;
}
/// <summary>
/// 查询数据操作
/// </summary>
private void btnSearch_Click(object sender, EventArgs e)
{
advanceCondition = null;//必须重置查询条件，否则可能会使用高级查询条件了
BindData();
}
5）根据类型转换不同的窗体
为了输入方便，我定义了几个不同输入内容的窗体，然后根据不同的字段类型，构造不同的窗体并进行显示，这样比较合理显示并接收客户的条件输入。
private void gridControl1_MouseDoubleClick(object sender, MouseEventArgs e)
{
int[] rowSelected = this.gridView1.GetSelectedRows();
if (rowSelected.Length == 0) return;
string fieldName = this.gridView1.GetFocusedRowCellValue("字段").ToString();
string fieldDisplay = this.gridView1.GetFocusedRowCellValue("字段名称").ToString();
FieldType fieldType = (FieldType)this.gridView1.GetFocusedRowCellValue("字段类型");
string fieldValue = this.gridView1.GetFocusedRowCellValue("查询条件值").ToString();
#region 根据类型转换不同的窗体
FrmQueryBase dlg = null;
if (fieldType == FieldType.Text)
{
dlg = new FrmQueryTextEdit();
}
else if (fieldType == FieldType.Numeric)
{
dlg = new FrmQueryNumericEdit();
}
else if (fieldType == FieldType.DateTime)
{
dlg = new FrmQueryDateEdit();
}
else if (fieldType == FieldType.DropdownList)
{
dlg = new FrmQueryDropdown();
}
#endregion
6）主窗体的事件响应
由于弹出的高级查询窗体，里面的查询以及清除操作，都是通过主窗体的事件进行处理，因此，弹出的高级查询窗体，只需要调用相应的事件即可。
dlg.DataClear += new FrmQueryBase.DataClearEventHandler(dlg_DataClear);
if (dlg.ShowDialog() == System.Windows.Forms.DialogResult.OK)
{
//更新查询界面显示
UpdateFieldValue(fieldName, dlg.ReturnValue, dlg.ReturnDisplay);
//更新父窗体的数据显示
ProcessDataSearch(null, null);
}
这样我们就能把传统查询功能和高级查询功能合并一起，发挥最大的作用，是我们的程序能够尽量满足客户的需求，获得更加好的反馈和支持了。
本文转自博客园伍华聪的博客，原文链接：Winform开发框架之通用高级查询模块，如需转载请自行联系原博主。