扩展GridView控件(3) - 根据按钮的CommandName设置其客户端属性

作者： webabcd

/* 正式版的实现 开始 */

介绍
扩展GridView控件：
根据按钮的CommandName设置其客户端属性

使用方法（设置ClientButtons集合属性）：
BoundCommandName - 需要绑定的CommandName
AttributeKey - 属性的名称
AttributeValue - 属性的值（两个占位符：{0} - CommandArgument；{1} - Text）
Position - 属性的值的位置


关键代码

using  System;
using  System.Collections.Generic;
using  System.Text;

using  System.Web.UI.WebControls;
using  System.Web.UI;

namespace  YYControls.SmartGridViewFunction
{
    /**//// 

    /// 扩展功能：根据按钮的CommandName设置其客户端属性
    /// 

    public class ClientButtonFunction : ExtendFunction
    {
        /**//// 

        /// 构造函数
        /// 

        public ClientButtonFunction()
            : base()
        {

        }

        /**//// 

        /// 构造函数
        /// 

        /// SmartGridView对象
        public ClientButtonFunction(SmartGridView sgv)
            : base(sgv)
        {

        }

        /**//// 

        /// 扩展功能的实现
        /// 

        protected override void Execute()
        {
            this._sgv.RowDataBoundCell += new SmartGridView.RowDataBoundCellHandler(_sgv_RowDataBoundCell);
        }

        /**//// 

        /// SmartGridView的RowDataBoundCell事件
        /// 

        /// 
        /// 
        void _sgv_RowDataBoundCell(object sender, GridViewTableCell gvtc)
        {
            TableCell tc = gvtc.TableCell;

            // TableCell里的每个Control
            foreach (Control c in tc.Controls)
            {
                // 如果控件继承自接口IButtonControl
                if (c is IButtonControl)
                {
                    // 从用户定义的ClientButtons集合中分解出ClientButton
                    foreach (ClientButton cb in this._sgv.ClientButtons)
                    {
                        // 如果在ClientButtons中绑定了该按钮的CommandName
                        if (((IButtonControl)c).CommandName == cb.BoundCommandName)
                        {
                            // 替换占位符{0}-CommandArgument；{1}-Text
                            string attributeValue = 
                                String.Format(
                                    cb.AttributeValue,
                                    ((IButtonControl)c).CommandArgument,
                                    ((IButtonControl)c).Text);
                            
                            // 设置按钮的客户端属性
                            YYControls.Helper.Common.SetAttribute(
                                (IAttributeAccessor)c, 
                                cb.AttributeKey, 
                                attributeValue, 
                                cb.Position);

                            break;
                        }
                    }
                }
            }
        }
    }
}

/* 正式版的实现 结束 */

/* 测试版的实现 开始 */

介绍
给按钮增加单击弹出确认框的功能是经常要用到的，我们一般是通过在RowDataBound事件里编码的方式实现，麻烦，所以扩展一下。


控件开发
1、新建一个继承自GridView的类。

/**/ /// 

/// 继承自GridView
/// 

[ToolboxData( @" <{0}:SmartGridView runat='server'> " )]
public   class  SmartGridView : GridView
{
}

2、新建一个ConfirmButton类，有两个属性

     /**/ /// 

    /// ConfirmButton 的摘要说明。
    /// 

    [ToolboxItem( false )]
    [TypeConverter( typeof (ConfirmButtonConverter))]
     public   class  ConfirmButton
     {
        private string _commandName;
        /**//// 

        /// 按钮的CommandName
        /// 

        public string CommandName
        {
            get { return this._commandName; }
            set { this._commandName = value; }
        }

        private string _confirmMessage;
        /**//// 

        /// 确认框弹出的信息
        /// 

        public string ConfirmMessage
        {
            get { return this._confirmMessage; }
            set { this._confirmMessage = value; }
        }
    }

3、新建一个继承自CollectionBase的类ConfirmButtons

     /**/ /// 

    /// ProjectGroups 的摘要说明。
    /// 注意要继承自CollectionBase
    /// 

    [
    ToolboxItem( false ),
    ParseChildren( true )
    ]
     public   class  ConfirmButtons : CollectionBase
     {
        /**//// 

        /// 构造函数
        /// 

        public ConfirmButtons()
            : base()
        {
        }

        /**//// 

        /// 实现IList接口
        /// 获取或设置指定索引处的元素。
        /// 

        /// 要获得或设置的元素从零开始的索引
        /// 
        public ConfirmButton this[int index]
        {
            get
            {
                return (ConfirmButton)base.List[index];
            }
            set
            {
                base.List[index] = (ConfirmButton)value;
            }
        }

        /**//// 

        /// 实现IList接口
        /// 将某项添加到 System.Collections.IList 中。
        /// 

        /// 要添加到 System.Collections.IList 的 System.Object。
        public void Add(ConfirmButton item)
        {
            base.List.Add(item);
        }

        /**//// 

        /// 实现IList接口
        /// 从 System.Collections.IList 中移除特定对象的第一个匹配项。
        /// 

        /// 要从 System.Collections.IList 移除的 System.Object
        public void Remove(int index)
        {
            if (index > -1 && index < base.Count)
            {
                base.List.RemoveAt(index);
            }
        }
    }

4、新建一个继承自ExpandableObjectConverter的类ConfirmButtonConverter

     /**/ /// 

    /// 类型转换器
    /// 

     public   class  ConfirmButtonConverter : ExpandableObjectConverter
     {
        /**//// 

        /// 返回值能否将ConfirmButton类型转换为String类型
        /// 

        /// 
        /// 
        /// 
        public override bool CanConvertTo(ITypeDescriptorContext context, Type destinationType)
        {
            if (destinationType == typeof(string))
            {
                return true;
            }
            return base.CanConvertTo(context, destinationType);
        }

        /**//// 

        /// 将ConfirmButton类型转换为String类型
        /// 

        /// 
        /// 
        /// 
        /// 
        /// 
        public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture,
            object value, Type destinationType)
        {
            if (value != null)
            {
                if (!(value is YYControls.SmartGridView.ConfirmButton))
                {
                    throw new ArgumentException(
                        "无效的ConfirmButton", "value");
                }
            }

            if (destinationType.Equals(typeof(string)))
            {
                if (value == null)
                {
                    return String.Empty;
                }
                return "ConfirmButton";
            }
            return base.ConvertTo(context, culture, value, destinationType);
        }
    }

5、在继承自GridView的类中加一个复杂对象属性，该复杂对象就是第3步创建的那个ConfirmButtons

         private  ConfirmButtons _confirmButtons;
         /**/ /// 

        /// 确认按钮集合
        /// 

        [
        PersistenceMode(PersistenceMode.InnerProperty),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Content),
        Description( " 确认按钮集合，确认按钮的CommandName和提示信息 " ),
        Category( " 扩展 " )
        ]
         public   virtual  ConfirmButtons ConfirmButtons
         {
            get
            {
                if (_confirmButtons == null)
                {
                    _confirmButtons = new ConfirmButtons();
                }
                return _confirmButtons;
            }
        }

6、重写OnRowDataBound实现单击命令按钮弹出确认框的功能。主要是给按钮增加一个客户端的onclick事件。

         /**/ /// 

        /// OnRowDataBound
        /// 

        /// 
         protected   override   void  OnRowDataBound(GridViewRowEventArgs e)
         {
            if (e.Row.RowType == DataControlRowType.DataRow)
            {
                if (this._confirmButtons != null)
                {
                    // GridViewRow的每个TableCell
                    foreach (TableCell tc in e.Row.Cells)
                    {
                        // TableCell里的每个Control
                        foreach (Control c in tc.Controls)
                        {
                            // 如果控件继承自接口IButtonControl
                            if (c.GetType().GetInterface("IButtonControl") != null && c.GetType().GetInterface("IButtonControl").Equals(typeof(IButtonControl)))
                            {
                                // 从用户定义的ConfirmButtons集合中分解出ConfirmButton
                                foreach (ConfirmButton cb in _confirmButtons)
                                {
                                    // 如果发现的按钮的CommandName在ConfirmButtons有定义的话
                                    if (((IButtonControl)c).CommandName == cb.CommandName)
                                    {
                                        // 增加确认框属性
                                        ((IAttributeAccessor)c).SetAttribute("onclick", "return confirm('" + cb.ConfirmMessage + "')");
                                        break;
                                    }
                                }
                            }
                        }
                    }
                }
            }

            base.OnRowDataBound(e);
        }

控件使用
添加这个控件到工具箱里，然后拖拽到webform上，设置其ConfirmButtons属性即可。CommandName是命令按钮的CommandName属性；ConfirmMessage是弹出的确认框所显示的文字。
ObjData.cs

using  System;
using  System.Data;
using  System.Configuration;
using  System.Web;
using  System.Web.Security;
using  System.Web.UI;
using  System.Web.UI.WebControls;
using  System.Web.UI.WebControls.WebParts;
using  System.Web.UI.HtmlControls;

using  System.ComponentModel;

/**/ /// 

/// OjbData 的摘要说明
/// 

public   class  OjbData
{
    public OjbData()
    {
        //
        // TODO: 在此处添加构造函数逻辑
        //
    }

    [DataObjectMethod(DataObjectMethodType.Select, true)]
    public DataTable Select()
    {
        DataTable dt = new DataTable();
        dt.Columns.Add("no", typeof(string));
        dt.Columns.Add("name", typeof(string));

        for (int i = 0; i < 30; i++)
        {
            DataRow dr = dt.NewRow();
            dr[0] = "no" + i.ToString().PadLeft(2, '0');
            dr[1] = "name" + i.ToString().PadLeft(2, '0');

            dt.Rows.Add(dr);
        }

        return dt;
    }
}

Default.aspx

<% @ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default"  %>

DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >
< html  xmlns ="http://www.w3.org/1999/xhtml" >
< head  runat ="server" >
     < title > 无标题页 title >
head >
< body >
     < form  id ="form1"  runat ="server" >
         < div >
              
             < yyc:SmartGridView  ID ="SmartGridView1"  runat ="server"  AutoGenerateColumns ="false"
                DataSourceID ="ObjectDataSource1" >
                 < Columns >
                     < asp:BoundField  DataField ="no"  HeaderText ="序号"  SortExpression ="no"   />
                     < asp:BoundField  DataField ="name"  HeaderText ="名称"  SortExpression ="name"   />
                     < asp:ButtonField  CommandName ="ConfirmTest"  Text ="确认按钮测试"   />
                 Columns >
                 < ConfirmButtons >
                     < yyc:ConfirmButton  ConfirmMessage ="确认删除吗？"  CommandName ="ConfirmTest" > yyc:ConfirmButton >
                 ConfirmButtons >
             yyc:SmartGridView >
             < asp:ObjectDataSource  ID ="ObjectDataSource1"  runat ="server"  SelectMethod ="Select"
                TypeName ="OjbData" > asp:ObjectDataSource >
         div >
     form >
body >
html >

/* 测试版的实现 结束 */