查询控件、分页控件、页面展示控件，我的Web开发三大得力助手

在我的Database2Sharp中，Web界面生成的代码都集成了查询控件、分页控件、页面展示控件，这几个控件可以简化很多代码，而且统一了风格，熟悉使用后，对开发Web具有不可估量的作用。

下面介绍下几个控件的功能和使用方法：

查询控件
1. 根据设定的字段属性在界面呈现相应的说明及控件
2. 支持下拉列表之间的联动，支持输入数据的验证操作。
3. 支持查询历史记录记忆功能
4. 支持日期控件的集成
5. 支持移动省公司界面样式集成

查询控件属性说明： 
 SearchFields            查询字段属性集合
 SortFieldName         排序字段名称
 ConnectionString     数据库链接字符串
 ColumnWidth          每个字段表格部分显示的宽度，0表示不设置
 InSQL         指定查询表初始部分的脚本
 OutSQL      传出的参数化SQL语句
 PagerParameters        和参数化SQL语句对应的参数集合
 RowControls              每行放置多少控件
 ContentControlWidth  所有控件展示为相同长度

 SearchButtonImage 查询按钮的图片（可选）
 ResetButtonImage   重置按钮图片（可选）
 SearchButtonText    查询按钮文本(默认为“查询”）
 ResetButtonText     重置按钮文本（默认为“重置”）
 AppendedButtons    在查询按钮附近追加的按钮

FieldInfo属性说明（默认使用前三个属性即可）：
 FieldName        数据库字段名称
 ViewName        字段的显示名称
 FieldType         字段类型

 DefaultValue     ListItem类型的默认值（用于下拉列表）
 Items               列表项目ListItem[]数组
 Enabled            控件是否可用（默认为True)
 TargetFieldName 联动时候的字段名称（用来定位联动的DropDownList）
 OnFillItem          用于添加联动列表内容的委托函数
 ColumnSpan      字段在布局中占多少个单元格

 

控件一般使用说明：
 1.页面代码

    <%@ Register TagPrefix="cc1" Namespace="WHC.SearchControl" Assembly="SearchControl" %>
    <cc2:SearchControl ID="SearchControl1" runat="server" Width="100%" RowControls="3"
                        InSQL="SELECT * FROM tb_acl_Roles" SearchButtonImage="http://www.cnblogs.com/Themes/Default/btn_search.gif"
                        ResetButtonImage="http://www.cnblogs.com/Themes/Default/btn_reset.gif"></cc2:SearchControl>

 

 2.页面后台代码

    protected void Page_Load(object sender, EventArgs e)
    {
        this.Pager1.PageRecords = this.PageSize;
        if (!IsPostBack)
        {
        FieldInfo name = new FieldInfo("Name", "角色名称", FieldType.String);
             FieldInfo remark = new FieldInfo("Remark", "角色备注", FieldType.String);
  
            this.SearchControl1.SearchFields = new FieldInfo[] { name, remark  };
        this.SearchControl1.SortFieldNames = "ID";//"ID";
        this.SearchControl1.ConnectionString = Helper.GetConnectionString();
        this.SearchControl1.ColumnWidth = new Unit[]{ Unit.Percentage(10), Unit.Percentage(23), Unit.Percentage(10), 
                                     Unit.Percentage(23), Unit.Percentage(10), Unit.Percentage(23) }; //设置列的宽度
        Helper.SetSearchControlStyle(SearchControl1);//设置控件样式
        this.SearchControl1.ContentControlWidth = Unit.Pixel(180); //所有控件使用一个宽度
                
        BindData();
        }
        
    this.SearchControl1.OutSQLValueChanged += new OutSQLChangedHandle(SearchControl1_OutSQLValueChanged);
    }

    private void BindData()
    {
        try
        {
            this.Pager1.ConnectionString = this.SearchControl1.ConnectionString;
            this.Pager1.PagerParameters = this.SearchControl1.PagerParameters;
            this.Pager1.SQL = this.SearchControl1.OutSQL;            
        }
        catch (Exception ex)
        {
            Helper.ShowError(this, ex, false);
            return;
        }
    }
    
    protected void SearchControl1_OutSQLValueChanged(object sender, OutSQLChangedEventArgs e)
    {
        BindData();
    }

 

如果是需要下拉列表的联动操作，实现也很方便，下拉列表联动介绍（城市和地区的联动例子）：

    private void Page_Load(object sender, EventArgs e)
    {  
            if (!Page.IsPostBack)
            {
             FieldInfo cityInfo = new FieldInfo("City", "城市", FieldType.String);
             cityInfo.Items = new ListItem[] { new ListItem("北京市", "北京"), new ListItem("广州"), new ListItem("成都") };
             cityInfo.TargetFieldName = "Area";
             cityInfo.OnFillItem += new AddItemHandler(this.OnFillItem);
         FieldInfo areaInfo = new FieldInfo("Area", "地区", FieldType.String);
             areaInfo.Items = new ListItem[0];
            }
    }


    private void OnFillItem(DropDownList ddListControl, string selItemValue)
    {
        ddListControl.Items.Clear();

        if (selItemValue.Trim().Length > 0)
        {
            string sql = string.Format("select Area from CityArea where City ='{0}' ", selItemValue);
                    using (SqlConnection connection = new SqlConnection(this.SearchControl1.ConnectionString))
            {
                connection.Open();
                SqlCommand com = new SqlCommand(sql, connection);
                using (IDataReader reader = com.ExecuteReader())
                {    
                    while (reader.Read())
                    {
                             ddListControl.Items.Add(new ListItem(reader["Area"].ToString()));
                    }
                }
            }
        }

        ddListControl.Items.Insert(0, new ListItem("--所有--", string.Empty));
    }

 

 

分页控件
和查询控件以及内置的Datagrid控件一起使用，可以实现功能：
1、可以进行分页（首页、上一页、下一页、末页），跳转到指定页面、数据导出功能等
2、支持表格头部排序功能，Datagrid支持表格样式迭代变化功能。
3. 支持移动省公司界面样式集成
4. 支持页面的页码和页面数量的数字记忆，

编辑控件属性说明：
 BindControlID 数据源控件，DataGrid的ID
 ExportEnabled 是否显示导出按钮
 ImageBasePath 图片地址的基础路径
 
 ConnectionString 数据库连接字符串
 PagerParameters  参数化集合
 SQL    分页SQL语句

控件使用说明：
 1.页面代码

<cc1:Pager ID="Pager1" runat="server" Height="20" BindControlID="dg" ImageBasePath="http://www.cnblogs.com/Themes/Default"
                    FirstImagePath="btn_sy.gif" NextImagePath="btn_xyy.gif" PreviousImagePath="btn_syy.gif"
                    LastImagePath="btn_wy.gif" GoImagePath="btn_go.gif" ExportImagePath="btn_export.gif"
                    ExportEnabled="false" />

 

 2.页面后台代码：

    private void Page_Load(object sender, EventArgs e)
    {
        if(!this.IsPostBack)
        {
            BindData();
        }
    }
    
    private void BindData()
    {
        try
        {
            this.Pager1.ConnectionString = this.SearchControl1.ConnectionString;
            this.Pager1.PagerParameters = this.SearchControl1.PagerParameters;
            this.Pager1.SQL = this.SearchControl1.OutSQL;
        }
        catch (Exception ex)
        {
            Helper.ShowError(this, ex, false);
            return;
        }
    }

    //DataGrid样式变化代码
    protected void dg_ItemDataBound(object sender, DataGridItemEventArgs e)
    {
        if (e.Item.ItemType == ListItemType.Item || e.Item.ItemType == ListItemType.AlternatingItem
            || e.Item.ItemType == ListItemType.EditItem)
        {
        //修改控件的值代码部分
        }

        if (e.Item.ItemType == ListItemType.Item ||
       e.Item.ItemType == ListItemType.AlternatingItem ||
       e.Item.ItemType == ListItemType.EditItem)
        {
            e.Item.Attributes.Add("onmouseover", "this.className='HighLightItem'");
        }

        if (e.Item.ItemType == ListItemType.Item)
        {
            e.Item.Attributes.Add("onmouseout", "this.className='Item'");
        }
        else if (e.Item.ItemType == ListItemType.AlternatingItem)
        {
            e.Item.Attributes.Add("onmouseout", "this.className ='AlternatingItem'");
        }
    }

    //排序头部处理
    protected void dg_ItemCreated(object sender, DataGridItemEventArgs e)
    {
        if (e.Item.ItemType == ListItemType.Header)
        {
            for (int i = 0; i < dg.Columns.Count; i++)
            {
                if (dg.Columns[i].SortExpression == this.SearchControl1.SortFieldNames)
                {
                    TableCell c = e.Item.Cells[i];
                    if (c.Controls.Count > 0 &&
                           c.Controls[0].GetType().ToString() == "System.Web.UI.WebControls.DataGridLinkButton")
                    {
                        Label lblArrow = new Label();
                        lblArrow.Font.Name = "Webdings";
                        if (this.SearchControl1.SortFieldAscend)
                        {
                            lblArrow.Text = "5";
                        }
                        else
                        {
                            lblArrow.Text = "6";
                        }
                        c.Controls.Add(lblArrow);

                        break;
                    }
                }
            }
        }
    }
    //排序部分代码
    protected void dg_SortCommand(object source, DataGridSortCommandEventArgs e)
    {
        if (e.SortExpression == this.SearchControl1.SortFieldNames)
        {
            if (this.SearchControl1.SortFieldAscend)
            {
                this.SearchControl1.SortFieldAscend = false;
            }
            else
            {
                this.SearchControl1.SortFieldAscend = true;
            }
        }
        else
        {
            this.SearchControl1.SortFieldNames = e.SortExpression;
            this.SearchControl1.SortFieldAscend = true;
        }

        BindData();
      
    }

 

 

页面展示控件

1. 支持查看、增加、编辑三种类型的页面展现
2. 根据设定的字段属性在界面呈现相应的说明及控件
3. 支持布局和样式修改
4. 支持日期控件的集成
5. 支持移动省公司界面样式集成

编辑控件属性说明： 
 EidtFields  新增或者编辑页面的字段信息
 EntityObject  对应的实体类对象
 ControlType  标识是新增、编辑还是查看已有的数据，默认为新增
 RowControls  每行放置的控件组数目，默认为2个
 LabelHorizontalAlign 标签的水平对齐方式
 ContentControlWidth  所有控件展示为相同长度

 ColumnWidth  列的宽度集合，宽度使用Unit类型
 RowHeight  行的高度集合，高度使用Unit类型

 ShowMessageBox  界面输入转换错误的时候，是否显示对话框，默认为True
 ShowErrorAfter  界面输入转换错误的时候，错误信息是否放在控件的后面，默认为false 

 OnCancel  处理取消并返回的委托
 OnSaveData  处理保存数据的委托

FieldInfo属性说明（默认使用前三个属性即可）：
 FieldName  数据库字段名称
 ViewName  字段的显示名称
 FieldType  字段类型

 Items   DropDownList或者CheckBoxList的列表项目。
 ItemsType  下拉列表的类别：DropDownList或者CheckBoxList
 DefaultValue  ListItem类型的默认值（用于下拉列表）
 TargetFieldName  联动时候的字段名称（用来定位联动的DropDownList）
 OnFillItem  用于添加联动列表内容的委托函数
 IsRequired   字段是否必填项，默认为False (如果是必填项，在界面上要求输入内容）
 Enabled   控件是否可用，默认为True
 ColumnSpan  字段在布局中占多少个单元格
 
 ToolTip   控件的提示文本(只能设置文本框的提示)
 MaxLength  文本框最大可以输入的内容长度
 TextBoxMode  文本款的呈现模式，可以是SingleLine、MulitLine、Passord类型
 TextRows  多行文本框显示的行数
 TextColumns  文本框显示的列字符数

控件使用说明：
 1.页面代码

 

<%@ Register TagPrefix="cc1" Namespace="WHC.EditControl" Assembly="EditControl" %>
     <cc1:EditControl id="EditControl1" RowControls="1" ShowErrorAfter="True" ShowMessageBox="True" runat="server" width="100%" 

SaveButtonImage="http://www.cnblogs.com/Themes/Default/btn_savetobox.gif" CancelButtonImage="http://www.cnblogs.com/Themes/Default/btn_Cancel.gif"></cc1:EditControl>

 

 2.页面后台代码：

 

    private const string CONNECTION_STRING = "Server=localhost;Database=Test;uid=sa;pwd=123456";

    private void Page_Load(object sender, EventArgs e)
    {
        if(!this.IsPostBack)
        {
            BindData();
        }
        
        this.EditControl1.OnCancel = new CancelHandler(this.OnCancel);
        this.EditControl1.OnSaveData = new SaveDataHandler(this.OnSaveData);
    }
    
    private void BindData()
    {
        ControlType controlType = GetControlType();
        this.EditControl1.ControlType = controlType;
        if(controlType == ControlType.Add)
        {
            EditControl1.EntityObject = new TestInfo();
        }
        else
        {
            int id = int.Parse(Request.QueryString["ID"]);
            EditControl1.EntityObject = FindByID(id);
        }
        
        FieldInfo nameInfo = new FieldInfo("Name", "姓名", FieldType.String);
        nameInfo.IsRequired = true;
        nameInfo.ToolTip = "请输入用户名称";
        if(controlType != ControlType.Add)
        {
            nameInfo.Enabled = false; //设置“名称”不可编辑
        }

        FieldInfo cityInfo = new FieldInfo("City", "城市", FieldType.String);
        cityInfo.Width = 100;
        cityInfo.DefaultValue = new ListItem[] {new ListItem("北京市", "北京"), new ListItem("广州"), new ListItem("成都"), new ListItem("武汉"),};
        cityInfo.TargetFieldName = "Area";
        cityInfo.AddItem = new AddItemHandler(this.AddItem);

        FieldInfo areaInfo = new FieldInfo("Area", "地区", FieldType.String);
        areaInfo.DefaultValue = new ListItem[0];

        FieldInfo manInfo = new FieldInfo("Man", "是否男性", FieldType.Boolean);
        manInfo.DefaultValue = new ListItem[] {new ListItem("男性", "True"), new ListItem("女性", "False")};
        FieldInfo birthInfo = new FieldInfo("Birthday", "出生日期", FieldType.DateTime);
        birthInfo.IsRequired = true;

        FieldInfo ageInfo = new FieldInfo("Age", "年龄", FieldType.Numeric);

        this.EditControl1.EidtFields = new FieldInfo[] {nameInfo, cityInfo, areaInfo, manInfo, birthInfo, ageInfo};

        this.EditControl1.RowControls = 3; //默认一行放置2个控件组
        this.EditControl1.ContentControlWidth = Unit.Pixel(180);//统一所有控件的长度
        this.EditControl1.ColumnWidth = new Unit[]{ Unit.Percentage(10), Unit.Percentage(20), Unit.Percentage(10), 
                                                    Unit.Percentage(20), Unit.Percentage(10), Unit.Percentage(20) }; //设置列的宽度
    }
    
    private ControlType GetControlType()
    {
        ControlType controlType;
        string type = Request.QueryString["type"];
        switch(type)
        {
            case "view"://查看页面
                controlType = ControlType.View;
                break;
            case "edit"://修改页面
                controlType = ControlType.Edit;
                break;    
            default ://增加页面
                controlType = ControlType.Add;
                break;
        }
        return controlType;
    }

    //您可以使用自己的业务类来获取相关数据
    private object FindByID(int id)
    {
        TestInfo testInfo = new TestInfo();

        string sql = string.Format("select * from test where id ='{0}' ", id);
        using (SqlConnection connection = new SqlConnection(CONNECTION_STRING))
        {
            connection.Open();
            SqlCommand com = new SqlCommand(sql, connection);

            using (IDataReader reader = com.ExecuteReader())
            {
                if (reader.Read())
                {
                    testInfo.ID = Convert.ToInt32(reader["ID"]);
                    testInfo.Name = reader["Name"].ToString();
                    testInfo.Age = Convert.ToInt32(reader["Age"]);
                    testInfo.Area = reader["Area"].ToString();
                    testInfo.Birthday = Convert.ToDateTime(reader["Birthday"]);
                    testInfo.City = reader["City"].ToString();
                    testInfo.Man = Convert.ToBoolean(reader["Man"]);
                }
            }
        }

        return testInfo;
    }

    private void AddItem(DropDownList ddListControl, string selItemValue)
    {
        ddListControl.Items.Clear();

        if (selItemValue.Trim().Length > 0)
        {
            string sql = string.Format("select Area from CityArea where City ='{0}' ", selItemValue);
            using (SqlConnection connection = new SqlConnection(CONNECTION_STRING))
            {
                connection.Open();
                SqlCommand com = new SqlCommand(sql, connection);
                using (IDataReader reader = com.ExecuteReader())
                {
                    while (reader.Read())
                    {
                        ddListControl.Items.Add(new ListItem(reader["Area"].ToString()));
                    }
                }
            }
        }
    }


    private void OnCancel()
    {
        Response.Redirect("Default.aspx");
    }

    /// <summary>
    /// 通过返回用户提交数据的实体类信息，您可以实现自己的新增保存、修改保存操作
    /// </summary>
    /// <param name="entity">新增或者修改的实体类信息</param>
    private void OnSaveData(object entity)
    {
        if (this.EditControl1.ControlType == ControlType.Add)
        {
            //在此保存新增页面的数据
            Response.Write("新增的页面数据：<br>");
            Response.Write(ReflectionUtil.GetProperties(entity));
        }
        else if(this.EditControl1.ControlType == ControlType.Edit)
        {
            Response.Write("编辑的页面数据：<br>");
            Response.Write(ReflectionUtil.GetProperties(entity));
        }
    }

 

 查询控件、分页控件、页面展示控件的测试项目下载：http://files.cnblogs.com/wuhuacong/MyControlProjects.rar