在我们做项目的时候经常想要按名称、编号进行查询数据，可在开发时会把最常用的查询条件写上，不常用的就不写了，也是因为把所有字段都写上太多了，布局不好看而且不实用。还有些查询条件几百年用那么一次，也不能用到时调整一下程序。基于这些考虑我们做的一个高级查询组件，可以把所有列都作为查询条件，把最常用的查询条件还正常放在页面上。点击高级查询按钮后，会有所以列作为筛选条件方便进行查找，别如果本次条件比较多还可以保存起来为一个查询方案，下次时可以方便再次查询。
1.1. 效果展示
图 2.1
高级查询页面
图 2.2
高级查询管理页面
图 2.3
1.2. 调用说明
1.2.1. 添加高级查询的公共js引用
<script src="~/Content/js/core/common.advanced_query.js"></script>
1.2.2. 定义查询事件
在定义查询的表格对象后，定义查询事件。下边的self.grid是datagrid的绑定对象。
this.executeQueryClick = function (post){
self.grid.queryParams($.extend(ko.toJS(self.queryForm), post));
}
1.2.3. 给表格绑定高级查询
通过下边的方式可以绑定高级查询，可以自动生成快速查询栏以及高级查询、清空的按钮
//通过拼html的方法，把选中的grid放进一个layout的center中，上方添加一个north，里边渲染快速查询方案以及方案配置的按钮
//_param = {
//gridName:"grid" //datagrid的id值
//grid:self.grid //需要高级查询的datagrid绑定对象
//_url:"/DEMO/DemoSingleTableAdvancedQuery/DemoSingleTableAdvancedQuery" //当前页面路径
//searchFunc:self.executeQueryClick //对应viewModel中的this.executeQueryClick方法
//flagSession:false //true表示从页面读取datagrid的editor属性自动生成查询列，false表示手动填写查询列
//flagCollapsed:true //true加载时查询栏展开，false表示合死，默认true
//GridViewName:"grid" //使用数据库中GridViewName存入值为GridViewName的数据进行高级查询，方便对现有数据进行处理，以及与cs程序互通。默认等于gridName，如为此值赋值，注意要同时修改controller中的查询列绑定值
//}
snf.advancedQueryLayout({
gridName:"grid",
grid :self.grid,
_url: "/DEMO/DemoSingleTableAdvancedQuery/DemoSingleTableAdvancedQuery",
searchFunc :self.executeQueryClick,
flagSession :false,
flagCollapsed: true
//GridViewName:"grid"
});
此方法应当在定义self.grid之后调用！
1.2.4. 如果不需要快速查询栏
通过此种方式可单独添加一个高级查询按钮，首先定义一个按钮，标签添加属性data-bind="click:advancedQueryClick"
this.advancedQueryClick=function(){
//只需要高级查询按钮，不需要快速查询栏时，调用此方法,参数如下，每个参数含义可参考2.2.3
snf.AdvancedQueryButtonClick({
gridName:"grid",
grid :self.grid,
_url: "/DEMO/DemoSingleTableAdvancedQuery/DemoSingleTableAdvancedQuery",
searchFunc :self.executeQueryClick,
flagSession :true,
//GridViewName:"grid"
});
}
1.2.5. 添加高级查询条件
flagSession=true时，会直接从editor中读取高级查询条件，如果flagSession=false，则要手动在controller中添加查询条件，代码如下
#region 获取高级查询的控件类型
[MvcMenuFilter(false)]
public dynamic GetAdvancedQueryColumns(RequestWrapper request)
{
var list = new List<KeyValuePair<string, object>>();
list.Add(new KeyValuePair<string, object>("grid", new object[]{
new string[]{ "DemoSingleTable.Code", "编号", "validatebox" },
new object[]{ "DropDownSingle", "数据字典", "combobox", this.GetItemsListCategoryBs("ItemsGender", "ItemCode", "ItemName")},
//new object[]{ "a", "a", "combotree", SNFService.Instance.BaseItemDetailsService.GetDataTable(this.UserInfo, "ItemsTreeTest")},
new string[]{ "Num", "数量", "numberbox", "min:0,precision:2" },
new string[]{ "Money", "金额", "numberspinner", "min:0,precision:2" },
new string[]{ "IsCheckbox", "复选框", "checkbox" },
new string[]{ "DateBox", "日期", "daterange" },
new string[]{ "ApproveState", "状态", "lookup", "lookupType:'ItemsAuditStatus'" }
}));
return list.Find(s => s.Key == request["GridViewName"]).Value;
}
#endregion
此方法应写在BaseApiController的继承类下
其中参数
list是一个列表，里边可以包含多个键值对，每个键都对应着一个表格控件。
每个键值对代表一个表格的高级查询绑定，键值对的key是绑定高级查询的表格的id值，键值对的value是一个object对象，包含对应表格的全部的高级查询所需的查询条件。此方法会自动根据表格id进行匹配，返回当前表格高级查询所需的查询条件列表。每个返回的查询条件对象中，可根据实际情况包含三到四个元素，主要控件类型不同有所区分。
注意：js当中advancedQueryClick方法的参数gridName与上面方法list的key值"grid"还有request["GridViewName"]要保持一致。
第一个元素：列名。对应数据库中的字段，多表查询时可输入表名.列名，如DemoSingleTable.Code
第二个元素：查询条件中文名，如：编号
第三个元素：控件类型，现在支持validatebox（文本框），combobox（下拉），
numberbox（数字框），numberspinner（数字微调框），checkbox（复选框），daterange（日期范围），lookup（弹框控件），combotree（下拉树）
第四个元素：扩展属性，对combobox、combotree来说，第四个值传下拉需要展示的数据源；对numberbox，numberspinner，lookup来说，第四个元素之间写easyui控件的data-options里边需要填写的内容即可（可以参考easyui1.3.2的api）；validatebox，daterange，checkbox不需要第四个元素
1.2.6. 在controller里的查询方法增加拼接查询条件的方法
SNFService.Instance.CreateService<BaseUserQuerysService, IBaseUserQuerysService>().GetParamQueryById(UserInfo, request, ref pQuery);
如图
图 2.4
1.2.7. demo样例
程序路径：
/DEMO/ DemoSingleTableAdvancedQuery /DemoSingleTableAdvancedQuery
可在程序中按照此路径增加菜单查看
1.1. 注意事项
一、如果多表查询的高级查询，需要将flagSession定义为false，并且在controller中定义的对象中，把每一列定义为 表名.列名
如图，画框部分为应当使用的写法
图 2.5
二、一个页面多个表格用到高级查询时，如果有多个表格需要在同一controller中进行高级查询的调用，请将各个表格的id值取成不同的，无论是否出现在同一cshtml页面中。调用时，每一表格需在图2.5的GetAdvancedQueryColumns方法中单独添加一段查询条件的代码。如，我们还有一个id为gridlist的表格也要进行高级查询，那么就在return的前一行加上如下代码：
list.Add(new KeyValuePair<string, object>("gridlist", new object[]{
new string[]{ "DemoSingleTable.Code", "编号", "validatebox" },
new object[]{ "DropDownSingle", "数据字典", "combobox", this.GetItemsListCategoryBs("ItemsGender", "ItemCode", "ItemName")},
//new object[]{ "a", "a", "combotree", SNFService.Instance.BaseItemDetailsService.GetDataTable(this.UserInfo, "ItemsTreeTest")},
new string[]{ "Num", "数量", "numberbox", "min:0,precision:2" },
new string[]{ "Money", "金额", "numberspinner", "min:0,precision:2" },
new string[]{ "IsCheckbox", "复选框", "checkbox" },
new string[]{ "DateBox", "日期", "daterange" },
new string[]{ "ApproveState", "状态", "lookup", "lookupType:'ItemsAuditStatus'" }
}));
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
这个系列教程文档，欢迎转载：
Winform开发框架之图表报表在线设计器-报表-SNF.EasyQuery项目--SNF快速开发平台3.3-Spring.Net.Framework
Winform开发框架之通用附件管理模块 --SNF快速开发平台3.3-Spring.Net.Framework
SNFAutoupdater通用自动升级组件V2.0-WinForm
SNF快速开发平台3.2之--.Net可扩展的单据编号生成器-SNF.CodeRule
SNF快速开发平台3.1之--审核流(3)低调奢华，简单不凡，实例演示-SNF.WorkFlow
SNF快速开发平台3.1之--审核流(2)流程设计-SNF.WorkFlow功能使用说明
SNF快速开发平台3.1之--审核流(1)SNF.WorkFlow审核流简介
SNF快速开发平台3.0之--完美的代码生成器SNF.CodeGenerator-快速开发者的利器
基于MVC4+EasyUI的Web开发框架--Spring.Net.FrameworkV3.0总体介绍
SNF快速开发平台3.0之--文件批量上传-统一附件管理器-在线预览文件(有互联网和没有两种)
SNF快速开发平台3.0之--asp.net mvc4 强大的导出和不需要上传文件的批量导入EXCEL
SNF快速开发平台3.0之MVC通用控件库展示-Asp.net+MVC4.0+WebAPI+EasyUI+Knockout
SNF快速开发平台3.0之BS页面展示和九大优点-部分页面显示效果-Asp.net+MVC4.0+WebAPI+EasyUI +Knockout
SNF快速开发平台3.0之-界面个性化配置+10种皮肤+7种菜单-Asp.net+MVC4.0+WebAPI+EasyUI+Knockout
作者： 王春天
QQ群：322581894 关于作者： 大连天翼信息科技有限公司 技术总监。 SNF快速开发平台 创始人。应用平台架构师、IT规划咨询专家、业务流程设计专家。 专注于快速开发平台的开发、代码生成器。同时专注于微软平台项目架构、管理和企业解决方案，多年项目开发与管理经验，精通DotNet系列技术Vue、.NetCore、MVC、Webapi、C#、WinForm等，DB（SqlServer、Oracle等）技术，移动端开发。熟悉Java、VB及PB开发语言。在面向对象、面向服务以及数据库领域有一定的造诣。现从事项目实施、开发、架构等工作。并从事用友软件产品U8、U9、PLM 客开工作。 如有问题或建议，请多多赐教！ 本文版权归作者和CNBLOGS博客共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，如有问题，可以通过邮箱或QQ 联系我，非常感谢。
