开源分享:相当但丰富于DataTable/View数据王国的“BaiDu”超级搜索过滤控件(源码直接贴出来,欢迎转载)
***名称***
淘金筛控件(WebMIS.GoldFilter)源码分享
***用法***
Step1 将淘金筛控件拖至WinForm/WebForm,假如命名为GoldFilter1;
将网格控件拖至WinForm/WebForm,假如命名为DataGrid1;
Step2 在Form_Load/Page_Load事件中过程中,设置DataGrid1的数据源之后,只需指定如下一句一切OK:
GoldFilter1.DataSource = DataGrid1.DataSource
Step3 程序运行时,GoldFilter1自动在WinForm/WebForm中为字段列下拉框加载数据源的各列或指定的列。
为操作类型下拉框加载各种操作,包括各种比较操作如=、<>、>、>=、<、<=、列举多个相等过滤、
两者之间范围比较等及其它的丰富的操作如包含、左包含、右包含模糊匹配。针对常用且实用的
长度判断、空值与非空值过滤特别智能匹配比较等。
***功能特点***
简单快捷、易用实用
***功能描述***
对DataTable/View各列做各种智能匹配、比较操作、模糊匹配查询过滤。
相当但丰富于DataTable/View数据王国的“BaiDu”
***适用范围***
各个网站网页或软件的网格数据过滤,通用于Oracel、SQLServer、ADO.NET的查询过滤。
***操作***
1、智能匹配
字段列下拉框选择一项,操作类型下拉框不用选,直接在过滤输入中输入过滤的数字或文本或日期即可查找过滤。
如果你输入了通配符如%、*号,自动做模糊匹配查找过滤。
2、比较操作
字段列下拉框选择一项,操作类型下拉框选择比较操作,直接在过滤输入中输入过滤的数字或文本或日期即可查找
过滤。
比较操作有如下几种:
相等、不等、大于、大于或等于、小于、小于或等于、两者之间、列举多个(相等)
3、模糊匹配
字段列下拉框选择一项,操作类型下拉框选择包含操作,直接在过滤输入中输入包含的数字或文本或日期即可查找
过滤。
包含操作有如下几种:
包含,过滤所有在过滤输入中的文本中出现的数据
左边象,过滤所有以在过滤输入中的文本开头的数据
右边象,过滤所有以在过滤输入中的文本结尾的数据
ValueTextItem.cs、ValueTextItemCollection.cs两个文件写的类是用来表示加载DataTable/View或网格列。
using System;
namespace WebMIS.GoldFilter
{
/// <summary>
/// 描述键值对,为清晰可见不用KeyValue而用ValueText,均以字符串形式配对,表示值及它的显示文本。
/// </summary>
public class ValueTextItem
{
private string _Value;
private string _Text;
/// <summary>
/// 创建类的新实例
/// </summary>
public ValueTextItem(){}
/// <param name="text">文本值,也就是键名与键值相同</param>
public ValueTextItem(string text):this(text,text)
{
}
/// <param name="val">值,即键名</param>
/// <param name="text">值对应的文本,一般用于显示</param>
public ValueTextItem(string val,string text)
{
_Value = val;
_Text = text;
}
/// <summary>
/// 值,即键名
/// </summary>
public string Value
{
get
{
return _Value;
}
set
{
_Value = value;
}
}
/// <summary>
/// 值对应的文本,一般用于显示
/// </summary>
public string Text
{
get
{
return _Text;
}
set
{
_Text = value;
}
}
/// <summary>
/// 以“值 - 文本”格式返回文本。
/// </summary>
/// <returns></returns>
public override string ToString()
{
return this.Value + " - " + this.Text;
}
}//End Struct
}//End Namespace
using System;
using System.Collections;
namespace WebMIS.GoldFilter
{
/// <summary>
/// 键值对集合
/// </summary>
public class ValueTextItemCollection:CollectionBase
{
public ValueTextItemCollection()
{
//
// TODO: 在此处添加构造函数逻辑
//
}
/// <summary>
/// 将指定的键值对添加到集合的结尾处
/// </summary>
/// <param name="item"></param>
/// <returns></returns>
public int Add(ValueTextItem item)
{
return this.InnerList.Add(item);
}
/// <summary>
/// 将指定的键值对添加到集合的结尾处
/// </summary>
/// <param name="item"></param>
/// <returns></returns>
public int Add(string val,string text)
{
return this.InnerList.Add(new ValueTextItem(val,text));
}
/// <summary>
/// 获取指定位置的键值对
/// </summary>
public ValueTextItem this[int index]
{
get
{
return this.InnerList[index] as ValueTextItem;
}
set
{
this.InnerList[index] = value;
}
}
/// <summary>
/// 从实例中移除特点的第一个匹配的键值对
/// </summary>
/// <param name="item"></param>
public void Remove(ValueTextItem item)
{
this.InnerList.Remove(item);
}
/*绑定到WinForm和WebForm列表控件
/// <summary>
/// 绑定到列表控件,如ComboBox、ListBox
/// </summary>
/// <param name="listControl">继承于ListControl的列表控件如ComboBox、ListBox</param>
public void BindingTo(System.Windows.Forms.ListControl listControl)
{
listControl.DataSource = this;
listControl.ValueMember = "Value";//ValueTextItem对像的属性名称
listControl.DisplayMember = "Text";
}
/// <summary>
/// 绑定到列表控件,如 CheckBoxList、DropDownList、ListBox 和 RadioButtonList
/// </summary>
/// <param name="listControl">继承于ListControl的列表控件如 CheckBoxList、DropDownList、ListBox 和 RadioButtonList</param>
public void BindingTo(System.Web.UI.WebControls.ListControl listControl)
{
listControl.DataSource = this;
listControl.DataValueField = "Value";
listControl.DataTextField = "Text";
}
*/
}//End Class
}//End Namespace
namespace WebMIS.GoldFilter
{
/// <summary>
/// 过滤操作类型,用于不同场合(Oracle、SqlServer、ADO.NET的RowFilter等)时对应的表达示可能不一样,这里统一定义常用包括比较操作、包含以及其它的操作类型。
/// 但注意如果类型为日期时间型的,如果仅有日期部分则可以完成日期的精确比较;如果带时间,如2005-9-15 00:00:01要完成与2005-9-15的比较,可用Bettween 2005-9-15 And 2005-9-16。
/// </summary>
public enum FilterOperationTypeFlags
{
#region 定义...
/*
/// 例Oracel中日期用to_date函数如Select to_date('字符字段','YYYY-MM-DD') From dual,Select to_char('日期字段','YYYY-MM-DD') From dual,而日期永远没有等于,用大于等于那一天并小于等于下一天即可。
/// SqlServer中用Convert()函数如Select CONVERT(nchar(10), 字段, 120),
/// DataView.RowFilter中用两个#界定日期如"Birthdate < #1/31/82#"(MSDN上是这么说的,其实用'还是可以,可我试了,对Oracel用等号没用,后来解决了,见相GetFilter中程序说明)。
/// 在DataView.RowFilter中数字型字段也可以用Like如rowfilter ="Convert(age, 'System.String') Like '1%'"
/// */
/// <summary>
/// 默认,即 fieldname = 'value',因为Oracle9i、SQLServer2K的数值与字符型及一些字段的SQL和RowFilter支持这种写法。
/// 如果包含了通配符,可以用模糊查询,但是必须转换为字符如rowfilter ="Convert(age, 'System.String') Like '1*'"。
/// </summary>
Default,
/// <summary>
/// 空值,即 fieldname is null,RowFilter="Isnull(fieldname,'Null Column') = 'Null Column'"。
/// </summary>
Null,
/// <summary>
/// 非空值,即 not(fieldname is null),RowFilter="Not(Isnull(fieldname,'Null Column') = 'Null Column')"。
/// </summary>
NotNull,
//******************通用比较******************
#region 定义比较类型包括=、<> 、>、>=、<、<=、Between...And...,In...,同时适用于字符、数字、日期类型。...
/// <summary>
/// 相等,即 fieldname = 'value'。
/// 注意如果类型为日期时间型的,如果仅有日期部分则可以完成日期的精确比较;如果带时间,如2005-9-15 00:00:01要完成与2005-9-15的比较,可用Bettween 2005-9-15 And 2005-9-16。
/// </summary>
Equal,
/// <summary>
/// 不相等,即 fieldname <> 'value'。
/// </summary>
UnEqual,
/// <summary>
/// 大于,即 fieldname > 'value'。
/// </summary>
Great,
/// <summary>
/// 大于等于,即 fieldname >= 'value'。
/// </summary>
GreatEqual,
/// <summary>
/// 小于,即 fieldname < 'value'。
/// </summary>
Little,
/// <summary>
/// 小于等于,即 fieldname <= 'value'。
/// </summary>
LittleEqual,
/// <summary>
/// 介于两值之间,包括两值在内,即 fieldname between 'value1' and 'value2',RowFilter="'value1' <= fieldname And fieldname <= 'value2'"
/// 注意如果类型为日期时间型的,如果仅有日期部分则可以完成日期的精确比较;如果带时间,如2005-9-15 00:00:01要完成与2005-9-15的比较,可用Bettween 2005-9-15 And 2005-9-16。
/// </summary>
BetweenAnd,
/// <summary>
/// 文本在...内,即 fieldname in ('value1','value2',...,'valuen')。
/// </summary>
In,
#endregion
//******************文本包含******************
#region 定义文本包含关系,对应Like关键字,数值、日期型如果转换成文本也可做包含。
/// <summary>
/// 文本包含,即 fieldname Like '%value%'。数值、日期型如果转换成文本也可做包含。。
/// </summary>
TextLike,
/// <summary>
/// 文本左边像,就是以文本开头,左起包含文本,即 fieldname Like 'value%'。数值、日期型如果转换成文本也可做包含。
/// </summary>
TextLeftLike,
/// <summary>
/// 文本右边像,就是以文本结尾,尾边包含文本,即 fieldname Like '%value'。数值、日期型如果转换成文本也可做包含。
/// </summary>
TextLikeRight,
#endregion
/// <summary>
/// 文本长度,即 Oracel\SqlServer\RowFilter分别为Lenght(fieldname) = value、Len(fieldname) = value。
/// </summary>
TextLength,
#endregion
}
/// <summary>
/// 过滤匹配值类型,例如单个比较的相等、Like,两者之间的BetweenAnd和多个的In操作。
/// </summary>
public enum FilterMatchingTypeFlags
{
#region 定义...
/// <summary>
/// 单一值。
/// </summary>
Single,
/// <summary>
/// 用逗号分隔的两个值,用于做介于两值之间的操作。
/// </summary>
BetweenAnd,
/// <summary>
/// 用逗号分隔的多个值,用于做在...内的操作,对应SQL的关键字IN。
/// </summary>
Multi
#endregion
}
/// <summary>
/// 数据过滤,作者:长江支流(周方勇)。下载:www.webmis.com.cn Email:flygoldfish@sina.com QQ:150439795
/// </summary>
public class DataFilter
{
public static string GetFilter(string fieldName,FilterOperationTypeFlags filterOperationType,string filterValue)
{
string strFilter = "";
string strfilterValue = ReplaceSQL(filterValue);
//关于RowFilter的MSDN解释摘录重点几个(其它请参见 DataColumn 类的 Expression 属性):
/*
若要形成 RowFilter 值,请指定列的名称,后跟一个运算符和一个要筛选的值。该值必须用引号括起来。
例如"LastName = 'Smith'"。
若要只返回那些具有空值的列,请使用以下表达式:
"Isnull(Col1,'Null Column') = 'Null Column'"
字符串值应放在单引号内。日期值应放在磅符号 (#) 内(经过试验,无效)。对于数值,允许使用小数和科学记数法。
字符串的开头和结尾处可以使用通配符,%与*等意, 在字符串的中间不允许使用通配符。例如,不允许 'te*xt'。
数据类型总是可以通过检查列的 DataType 属性来确定。还可以使用 Convert 函数来转换数据类型,语法为Convert(expression, dataType)
如"Convert(total, 'System.Int32')"
其它函数支持,如LEN、ISNULL、IIF、TRIM、SUBSTRING
*/
switch(filterOperationType)
{
#region 实现...
case FilterOperationTypeFlags.Default:
//可输入通配符
strFilter = GetStringMatchingFilter(fieldName,strfilterValue);
break;
case FilterOperationTypeFlags.Null:
//strFilter = fieldName + " Is NULL";
strFilter = "Isnull(" + fieldName + ",'Null Column') = 'Null Column'";//这个对空值有效,反而对Int型的无效了
break;
case FilterOperationTypeFlags.NotNull:
//strFilter = "Not(" + fieldName + " Is NULL)";
strFilter = "Not(Isnull(" + fieldName + ",'Null Column') = 'Null Column')";
break;
case FilterOperationTypeFlags.TextLength:
//strFilter = "Length(" + fieldName + ") = " + strfilterValue;//Oracel
//strFilter = "Length(" + fieldName + ") = " + strfilterValue;//SqlServer
strFilter = "Len(" + fieldName + ") = " + strfilterValue;//RowFilter
break;
#region 比较运算,同时适用于字符、数字、日期类型...
case FilterOperationTypeFlags.Equal:
strFilter = fieldName + "='" + strfilterValue + "'";
break;
case FilterOperationTypeFlags.UnEqual:
strFilter = fieldName + "<>'" + strfilterValue + "'";
break;
case FilterOperationTypeFlags.Great:
strFilter = fieldName + ">'" + strfilterValue + "'";
break;
case FilterOperationTypeFlags.GreatEqual:
strFilter = fieldName + ">='" + strfilterValue + "'";
break;
case FilterOperationTypeFlags.Little:
strFilter = fieldName + "<'" + strfilterValue + "'";
break;
case FilterOperationTypeFlags.LittleEqual:
strFilter = fieldName + "<='" + strfilterValue + "'";
break;
case FilterOperationTypeFlags.BetweenAnd:
//用逗号分隔的两个值
strFilter = GetStringMatchingFilter(fieldName,strfilterValue,FilterMatchingTypeFlags.BetweenAnd);
break;
case FilterOperationTypeFlags.In:
//用逗号分隔的多个值
strFilter = GetStringMatchingFilter(fieldName,strfilterValue,FilterMatchingTypeFlags.Multi);
break;
#endregion
#region 定义文本包含关系,对应Like关键字,数值、日期型如果转换成文本也可做包含。
case FilterOperationTypeFlags.TextLike:
strFilter = fieldName + " Like '%" + strfilterValue + "%'";
break;
case FilterOperationTypeFlags.TextLeftLike:
strFilter = fieldName + " Like '" + strfilterValue + "%'";
break;
case FilterOperationTypeFlags.TextLikeRight:
strFilter = fieldName + " Like '%" + strfilterValue + "'";
break;
#endregion
default:
//一般支持加单引号界定
strFilter = fieldName + "='" + strfilterValue + "'";
break;
#endregion
}
return strFilter;
}
/// <summary>
/// 获取数据表或数据视图指定列的过滤字符串,这里根据视图所在的表的指定列自动判断了数值、文本、日期型,如果还有其它的,再完善。
/// 如果列是字符类型,则可以用匹配或模糊(根据是否有通配符)查询;如果是数值型,则完全相等匹配;如果是日期型,查指定日,如带时间,查指定时间及之后的值。
/// </summary>
/// <param name="dataView">数据视图</param>
/// <param name="colName">列名,系统自动根据表中指定的列判断数据类型。</param>
/// <param name="filterValue">过滤值,还可以输入通配符</param>
/// <returns>返回指定列的过滤条件。</returns>
public static string GetFilter(DataView dataView,string colName,string filterValue)
{
return GetFilter(dataView.Table,colName,filterValue);
}
/// <summary>
/// 获取数据表或数据视图指定列的过滤字符串,这里根据表的指定列自动判断了数值、文本、日期型,如果还有其它的,再完善。
/// </summary>
/// <param name="dataTable">数据表</param>
/// <param name="colName">列名</param>
/// <param name="filterValue">过滤值,如果是字符串,还可以输入通配符</param>
/// <returns>返回指定列的过滤条件。</returns>
public static string GetFilter(DataTable dataTable,string colName,string filterValue)
{
#region 实现...
string strFilter = "";
string strfilterValue = ReplaceSQL(filterValue);
System.Type dataType = dataTable.Columns[colName].DataType;
System.TypeCode typeCode = System.Type.GetTypeCode(dataType);
//所以类型可以加引号,但是为了效率,相应的判断一下。
//规则参见RowFilter和DataColumn.Expression属性
//"Isnull(Col1,'Null Column') = 'Null Column'"
//字符串值应放在单引号内。日期值应放在磅符号 (#) 内。对于数值,允许使用小数和科学记数法
//字符串
if(typeCode == System.TypeCode.String)
{
//字符串,用户可以直接输入通配符,通用的是%与_,而Access为*与?
strFilter = GetStringMatchingFilter(colName,strfilterValue);
}
//数值型
else if (typeCode == System.TypeCode.Byte ||
typeCode == System.TypeCode.Char ||
typeCode == System.TypeCode.Decimal ||
typeCode == System.TypeCode.Double ||
typeCode == System.TypeCode.Int16 ||
typeCode == System.TypeCode.Int32 ||
typeCode == System.TypeCode.Int64 ||
typeCode == System.TypeCode.SByte ||
typeCode == System.TypeCode.Single ||
typeCode == System.TypeCode.UInt16 ||
typeCode == System.TypeCode.UInt32 ||
typeCode == System.TypeCode.UInt64)
{
//数值,完全相等,虽然可以加单引号,但是为了提高效率数字相比快。
strFilter = colName + "=" + strfilterValue;
}
else if(typeCode == System.TypeCode.DateTime)
{
//日期,完全相等
/*以下几种不行
strFilter = colName + "='" + strfilterValue + "'";
strFilter = colName + "=#" + strfilterValue + "#";
strFilter = "Convert(" + colName + ",'System.String')='" + strfilterValue + "'";
strFilter = "Convert(" + colName + ",'System.String')=#" + strfilterValue + "#";
strFilter = colName + "=Convert(" + strfilterValue + ",'System.DateTime')";
*/
//strFilter = "Convert(" + colName + ",'System.DateTime')" + "=Convert(" + strfilterValue + ",'System.DateTime')";
/// 例Oracel中日期用to_date函数把字符或字符字段转换成日期(不能转换日期字段本身)如Select to_date('字符字段','YYYY-MM-DD') From dual,
/// 而日期字段本身要格式则用 to_char 如 Select to_char('日期字段','YYYY-MM-DD') From dual,而日期永远没有等于,用大于等于那一天并小于等于下一天即可。
/// SqlServer中用Convert()函数如Select CONVERT(nchar(10), 字段, 120),
try
{
System.DateTime dtStart = System.DateTime.Parse(strfilterValue);
System.DateTime dtEnd = dtStart.AddDays(1);
//MSDN说用#界定,经过运行试验,传统的'还是可以界定。
//主要为了对付Oracel,其它的可以直接用=,Oracel的日期在内核中是用数字表示的,所以他带了时间,根本仅日期比较永远不可能相等。
//strFilter = colName + ">=#" + dtStart.ToString() + "# And " + colName + "<#" + dtEnd.ToString() + "#";//<#改为<=#在Oracel中也只是查dtStart这一天,没有查出下一天,不知其它DB如何,待试。。。
strFilter = colName + ">='" + dtStart.ToString() + "' And " + colName + "<'" + dtEnd.ToString() + "'";
}
catch{}
}
else
{
//其它,完全相等
strFilter = colName + "='" + strfilterValue + "'";
}
return strFilter;
#endregion
}
/// <summary>
/// 将原SQL替换为新的SQL,主要是对一些特殊字符进行处理如一个单引号替换成两个单引号。
/// </summary>
/// <param name="strSQL"></param>
/// <returns></returns>
private static string ReplaceSQL(string sql)
{
string strSql = sql;
strSql = strSql.Replace("'", "''");
return strSql;
}
/// <summary>
/// 智能组合LIKE、=、In或BetweenAnd操作,通用于标准SQL和ADO.NET的RowFilter。
/// 根据是否有通配符决定是完全匹配还是模糊查找,如果用于RowFilter,字符型之外的其它类型可用转换函数Convert执行类字符串的操作如"Convert(age, 'System.String') Like '1%'"。
/// 字符串的开头和结尾处可以使用通配符,%与*等意, 在字符串的中间不允许使用通配符。
/// </summary>
/// <param name="colName">列名</param>
/// <param name="filterValue">过滤值,单值情况下还可以输入通配符(通用的是%与_,而Access为*与?),其它用逗号分隔。</param>
/// <returns></returns>
public static string GetStringMatchingFilter(string colName,string filterValue)
{
return GetStringMatchingFilter(colName,filterValue,FilterMatchingTypeFlags.Single);
}
/// <param name="filterMathcingTypeFlags">过滤值类型,单一值可以用匹配或模糊查询,多个值用In查询,而两者之间的操作用BetweenAnd,非单一值用逗号分隔。</param>
/// <returns></returns>
public static string GetStringMatchingFilter(string colName,string filterValue,FilterMatchingTypeFlags filterMathcingTypeFlags)
{
//智能组合LIKE、=、In或BetweenAnd操作。
#region 实现...
string strFilter = "";
switch(filterMathcingTypeFlags)
{
case FilterMatchingTypeFlags.Single:
//字符串,用户可以直接输入通配符,通用的是%与_,而Access为*与?
if (filterValue.IndexOf('%') > -1 || filterValue.IndexOf('_') > -1 || filterValue.IndexOf('*') > -1 || filterValue.IndexOf('?') > -1)
{
//包含通配符则模糊查询
strFilter = colName + " LIKE '" + filterValue + "'";
}
else
{
//直接相等,以提高效率
strFilter = colName + "='" + filterValue + "'";
}
break;
case FilterMatchingTypeFlags.BetweenAnd:
if(filterValue == null || filterValue == "")
{
strFilter = colName + "=''";
}
else
{
//接受分隔符,或;或-或~
string[] arr = filterValue.Split(',');
if (arr.Length == 1)
{
if (filterValue.IndexOf(';') > -1)
{
arr = filterValue.Split(';');
}
else if (filterValue.IndexOf('-') > -1)
{
arr = filterValue.Split('-');
}
else if (filterValue.IndexOf('~') > -1)
{
arr = filterValue.Split('~');
}
}
if (arr.Length > 1)
{
//在ADO.NET中,经过试验RowFilter不支持Between...And...
//strFilter = colName + " Between '" + arr[0] + "' And '" + arr[1] + "'";
strFilter = colName + ">= '" + arr[0] + "' And " + colName + "<='" + arr[1] + "'";
}
else
{
strFilter = colName + "=''";
}
}
break;
case FilterMatchingTypeFlags.Multi:
if(filterValue == null || filterValue == "")
{
strFilter = colName + "=''";
}
else
{
strFilter = colName + " In (";
//接受分隔符,或;或-或~
string[] arr = filterValue.Split(',');
if (arr.Length == 1)
{
if (filterValue.IndexOf(';') > -1)
{
arr = filterValue.Split(';');
}
}
for(int i = 0 ; i < arr.Length ; i++)
{
strFilter += "'" + arr[i] + "',";
}
//去掉最后一个多余的逗号
strFilter = strFilter.Remove(strFilter.Length -1,1);
strFilter += ")";
}
break;
}
return strFilter;
#endregion 实现...
}
}//End Class
}//End Namespace