Winform开发框架之通用高级查询模块

时间:2021-06-04 07:21:04

最近一直忙于公司的事情,虽然一直在做一些相关的技术研究,但是很久没能静下心来好好写写博客文章了,想想也有半个月之多了,这半个月来,也一直致力于改善我的WInform开发框架,使得自己及客户使用起来更加方便,更加友好,更加高效。本篇文章就是介绍最近框架改善的其中一个闪光点"通用高级查询模块",高级查询模块,在很多程序模块中都很常见,也是给客户扩展查询的一个很好的补充,由于我一直希望我的Winform开发框架能够精益求精,所以做了这个模块,希望对今后我自己所有的项目以及框架本身,都能高效的使用。

1、通用高级查询模块的用途及介绍

既然称之为通用查询模块,那么他就不能与具体的表字段有耦合关系,但是要实现具体的查询,必须通过某种方式进行属性传递,实现更直观友好的字段查询功能。高级查询模块,在很多完善的程序上都会提供,用于满足用户对特定的字段,添加特定的条件进行,因为一般情况下,由于版面的限制界面上查询的内容比较有限,只是把一些很常见、重要的字段作为查询输入,如果表字段比较多,那么对有些特殊的字段就无所适从。

例如,我一个病人资料管理系统的界面如下所示

Winform开发框架之通用高级查询模块

这个界面已经放置的比较多输入控件进行查询了,如果放置更多,超过3行就会导致感觉比较臃肿了。所以合理的应该是把不常用的放到高级查询里面,这样用户需要更多条件的定制,可以在高级查询中对每个字段都能进行搜索,常规的在主界面即可查询。

我的高级查询查询模块也是基于这个道理,因此,在主界面增加一个高级查询按钮入口,如上图所示,单击后,显示一个所有字段的列表,如下界面。

Winform开发框架之通用高级查询模块

这样所有表的字段均可进行查询了,但是我们注意到,这个界面并没有输入条件的地方,没错,这个只是显示条件内容,浮在主界面的查询列表上面,如果设置条件后,主界面的列表会根据高级查询条件进行查询,这样也是符合客户实际的期望的。

在介绍输入条件的时候,我们注意到,查询输入,基本上可以分为几类:其一是常规的文本类型,使用文本框替代即可;其二是下拉列表类型,用户从列表下面选择内容;其三是日期类型,需要用户指定开始日期和结束日期;其四是数字类型,需要用户指定起始和结束的数值。

刚才说到,上面的高级查询界面,只是显示,但用户双击列表或者按下回车键,那么根据字段类型,弹出对应上面说到的四种输入框,用于接收用户的输入。

1)常规的文本类型条件输入界面:

Winform开发框架之通用高级查询模块

下拉列表类型条件输入界面:

Winform开发框架之通用高级查询模块

日期类型条件输入界面:

Winform开发框架之通用高级查询模块

数字类型条件输入界面:

Winform开发框架之通用高级查询模块

输入以上几种条件后,高级查询界面里面会显示友好的条件内容,确保用户能够看懂输入的条件,如下所示是输入几个不同类型的条件的显示内容。

Winform开发框架之通用高级查询模块

日期类型和数字类型,为了方便,都可以单独输入其中的一部分作为条件进行高级查询。

为了方便,高级查询模块的内容,可以进行查询后在主界面列表中显示,也可以使用传统的查询按钮进行查询,使用传统查询按钮后,高级查询条件将失效,但是保留用户的输入,第二次打开界面后,会加载之前的输入条件,这样比较人性化一些,用户可以随时*切换两种查询方式。

对于一些字段多的历史资料表,这种高级查询模式更加能够发挥其作用,用户可以在几十个甚至上百个字段中选择合适的条件,然后输入进行查询,这样能够使得客户更加有认同感,例如下面是一个病人历史档案资料表的高级查询界面,里面很多字段,使用这个扩展查询就是最合适不过了。

Winform开发框架之通用高级查询模块

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)设置高级查询的字段显示(有时候可能需要过滤部分字段)

Winform开发框架之通用高级查询模块

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 == ) 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);
}

这样我们就能把传统查询功能和高级查询功能合并一起,发挥最大的作用,是我们的程序能够尽量满足客户的需求,获得更加好的反馈和支持了。