本文将描述如何使CheckBoxList中的Item添加的Attribute在客户端生效,CheckBoxList是一个非常好用的组件,它支持数据绑定等特性。但是他和DropDownList有同样的一个问题,就是当我们向它们的Items里面Add项目的时候,如果希望给这些Item添加客户端行为,这些行为并不能体现在客户端,我们通常使用的方法如下:
HTML页面部分如下:
<asp:CheckBoxList id="CheckBoxList1" runat="server">
<asp:ListItem Value="1">1</asp:ListItem>
<asp:ListItem Value="2">2</asp:ListItem>
<asp:ListItem Value="3">3</asp:ListItem>
</asp:CheckBoxList>
我们在Page_Load里面添加如下代码:
foreach(ListItem item in this.CheckBoxList1.Items){
item.Attributes.Add("onclick","alert('"+item.Text+"')");
}
这样做的目的是:当我们点击CheckBox的时候希望alert出来我们选中的CheckBox的内容,当然还有其他的一些更有用的应用。但是实际上这段代码是不能正常工作的。我们在客户端点击CheckBox的时候看不到提示信息,同样不论你向Attributs中添加什么都不会有任何反应的。同样的问题也存在于其他的List控件中,比如:DropDownList等。
下面是这个页面呈现的客户端脚本:
<table id="CheckBoxList1" border="0">
<tr><td><input id="CheckBoxList1_0" type="checkbox" name="CheckBoxList1:0" /><label for="CheckBoxList1_0">1</label></td>
</tr>
<tr><td><input id="CheckBoxList1_1" type="checkbox" name="CheckBoxList1:1" /><label for="CheckBoxList1_1">2</label></td>
</tr>
<tr><td><input id="CheckBoxList1_2" type="checkbox" name="CheckBoxList1:2" /><label for="CheckBoxList1_2">3</label></td>
</tr>
</table>
可以看出来这里并没有我们期望的onclick事件。
下面我将提供一种方法来完善这个控件,既然是完善,那么我会保持该控件原有的所有特性并修复上面这个bug(我认为应该是一个bug),可能已经有人想到了使用什么方法,对,我将使用继承的方式复用这个控件。并在我们的新控件上做些手脚,使它更好用,我命名这个控件名叫NewCheckBoxList。
我们首先从分析客户端代码开始,我们发现在服务器上写的代码在客户端没有任何表现,那么怎么才能表现出来呢?这里我将重写该组件的Render方法,来完成最终的目的。下面就描述一下我的思路,首先我会从Render中将本来应该输出到页面的流,输出到一个StringBuilder里面,这样我就有机会编辑这个StringBuilder来完成剩下的工作,获得这个StringBuilder之后我们将按照我们希望的逻辑来为这个字符串添加内容,当内容添加完之后将这个字符串写到控件的输出流中即可。
下面是控件的实现代码:
using System;
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Text;
namespace Cuike519.Web.UI.WebControls {
namespace Cuike519.Web.UI.WebControls {
/// <summary>
/// Summary description for NewCheckBoxList.
/// </summary>
[DefaultProperty("Text"),
ToolboxData("<{0}:NewCheckBoxList runat=server></{0}:NewCheckBoxList>")]
public class NewCheckBoxList : System.Web.UI.WebControls.CheckBoxList {
protected override void Render(HtmlTextWriter writer) {
protected override void Render(HtmlTextWriter writer) {
StringBuilder sb = new StringBuilder();
System.IO.TextWriter tw = new System.IO.StringWriter(sb);
HtmlTextWriter OriginalStream = new HtmlTextWriter(tw);
base.Render(OriginalStream);
string s = sb.ToString();
int start = 0;
int end = s.Length;
for(int i = 0;i< this.Items.Count;i++){
start = s.IndexOf("<input",start,end-start);
StringBuilder sbItemAttribute = new StringBuilder();
this.Items[i].Attributes.Render(new HtmlTextWriter(new System.IO.StringWriter(sbItemAttribute)));
s = s.Insert(start+7,sbItemAttribute.ToString()+" ");
start = s.IndexOf("/>",start,s.Length-start);
end += sbItemAttribute.Length+1;
}
writer.Write(s);
}
}
}
代码说明如下:
我将构造一个StringBuilder来保存该控件呈现的内容(这个内容并不完整需要修改),我们利用base.Render将原始流写到sb里面,接着会获得其字符串,然后我们会在整个字符串中的指定位置查找对应的input,这里的算法应该还可以优化,有兴趣的网友可以试试。我会找到上一个input结尾的/>作为下一个查找的开始。在找到字符串之后我将利用item.Attribute的Render方法将我们在叶面中添加的内容输出到一个新的StringBuilder中(过程类似前面),接着我们会将这个输出写到原始流字符种合适的位置。到此控件算是修改完成了,下面是测试结果:
我们在使用该控件的页面中添加一个下面的指令:
<%@ Register TagPrefix="ck" Namespace="Cuike519.Web.UI.WebControls" Assembly="Test" %>
指明一些必要的参数,这里的Test就是我的测试工程生成的Assembly。页面的控件部分如下:
<ck:NewCheckBoxList id="NewCheckBoxList1" runat="server">
<asp:ListItem Value="a">a</asp:ListItem>
<asp:ListItem Value="b">b</asp:ListItem>
<asp:ListItem Value="c">c</asp:ListItem>
</ck:NewCheckBoxList>
我们在页面的Load写上面同样的代码:
foreach(ListItem item in this.NewCheckBoxList1.Items){
item.Attributes.Add("onclick","alert('"+item.Text+"')");
}
同样的代码只是更换了控件,让我们看看运行效果,下面是产生的客户端脚本:
<table id="NewCheckBoxList1" border="0">
<tr><td><input onclick="alert('a')" id="NewCheckBoxList1_0" type="checkbox" name="NewCheckBoxList1:0" /><label for="NewCheckBoxList1_0">a</label></td>
</tr>
<tr><td><input onclick="alert('b')" id="NewCheckBoxList1_1" type="checkbox" name="NewCheckBoxList1:1" /><label for="NewCheckBoxList1_1">b</label></td>
</tr>
<tr><td><input onclick="alert('c')" id="NewCheckBoxList1_2" type="checkbox" name="NewCheckBoxList1:2" /><label for="NewCheckBoxList1_2">c</label></td>
</tr>
</table>
是不是和上一个不一样?J 同样的方法也适用于DropDownList等组件。
下面是NewDropDownList实现的部分代码,替换NewCheckBoxList的对应部分即可:
for(int i = 0;i< this.Items.Count;i++){
start = s.IndexOf("<option",start,end-start);
StringBuilder sbItemAttribute = new StringBuilder();
this.Items[i].Attributes.Render(new HtmlTextWriter(new System.IO.StringWriter(sbItemAttribute)));
s = s.Insert(start+7,sbItemAttribute.ToString()+" ");
start = s.IndexOf("</option>",start,s.Length-start);
end += sbItemAttribute.Length+1;
}
该文章灵感来源于CSDN的网友提问。