TemplatedListCommandEventArgs args =
new TemplatedListCommandEventArgs(this, source, (CommandEventArgs)e);
RaiseBubbleEvent(this, args);
return true;
}
return false;
}
3、控件停止事件冒泡并引发和/或处理该事件。引发事件需要调用将事件调度给侦听器的方法。若要引发冒泡的事件,控件必须重写 OnBubbleEvent 以调用引发此冒泡的事件的 OnEventName 方法。引发冒泡的事件的控件通常将冒泡的事件公开为顶级事件。
protected override bool OnBubbleEvent(object source, EventArgs e) {
bool handled = false;
if (e is TemplatedListCommandEventArgs) {
TemplatedListCommandEventArgs ce = (TemplatedListCommandEventArgs)e;
OnItemCommand(ce);
handled = true;
}
return handled;
}
模板化控件
使用模版化控件,控件开发者可以通过template指定生成的全部或者部分UI。模板是页面语法的一部分,可以包括静态的HTML(HTML语法表达的控件实际上是子控件,但是属于LiteralControl控件)以及其他文自文本的服务器控件。模板功能,允许将控制数据与其表示分开。模板控件本身不提供用户界面 (UI)。该控件的 UI 由页面开发人员通过内联模板提供,该模板允许页面开发人员自定义该控件的 UI。通过使用模板,控件生成不同于样式的UI,但是这种UI能力主要是产生页面元素。譬如repeater控件等。
要支持模板化,控件必须实现Itemplate接口。页面解析器解析模板标签内的文本,并生成一个解析树来表示模板的内容,就像解析整个Page一样。支持模板控件开发需要做到:
1、实现 System.Web.UI.INamingContainer 接口。这是没有任何方法的标记接口。它可以在您的控件下创建新的命名范围,这样子控件就在名称树中有了唯一的标识符。
public class TemplatedFirstControl : Control,INamingContainer {...}
2、将 ParseChildrenAttribute 应用到控件,并传递 true 作为参数。在 ASP.NET 页上声明性地使用控件时,这样可指示页分析器如何分析模板属性标记。步骤 3 说明如何定义一个模板属性。 注意 如果您的控件是从 WebControl 派生的,则不需要应用 ParseChildrenAttribute,因为 WebControl 已经用该属性作了标记。
[ ParseChildren(ChildrenAsProperties = true)]
public class TemplatedFirstControl : Control, INamingContainer {...}
3、定义 System.Web.UI.ITemplate 类型的一个或多个属性。ITemplate 有一个方法 InstantiateIn,该方法可使用页上内联提供的模板创建控件。不必实现 InstantiateIn 方法;ASP.NET 页框架可提供这种实现。ITemplate 属性必须有 System.Web.UI.TemplateContainerAttribute 类型的元数据属性,它指出哪种 INamingContainer 控件将拥有实例化模板。这在步骤 4 中作了说明。如下代码所示定义了一个模板属性。
[TemplateContainer(typeof(FirstTemplateContainer))]
public ITemplate FirstTemplate {...}
4、TemplateContainerAttribute 的参数是您想在其中实例化模板的容器控件类型。容器控件独立于正在创作的模板控件。具有逻辑容器的原因是:模板控件通常有一个模板,该模板需要使用不同数据重复实例化。拥有与根模板控件不同的容器控件,使拥有多个此类示例成为可能。逻辑容器是该模板内子控件的即时 INamingContainer。在开发模板化数据绑定控件中更详细地介绍了这种关系。
注意 容器控件本身必须实现 INamingContainer,因为它有需要在页上唯一命名的子控件。但是容器仅仅是容器,对应需要解释的模板内容,并非控件。
public class FirstTemplateContainer : Control, INamingContainer {...}
5、重写 CreateChildControls 方法以便在模板中创建子控件。这是通过三个步骤来完成的。
实例化模板容器。
调用模板属性的 InstantiateIn 方法并将该容器作为参数传递给它。InstantiateIn 方法(在 ITemplate 接口中声明)实例化该模板的元素,作为该模板容器的子控件。不必实现 InstantiateIn 方法;ASP.NET 页框架可提供这种实现。
将模板容器的示例添加到您的模板控件的 Controls 集合。
以下代码片段说明了 CreateChildControls 的实现。
private Control myTemplateContainer;
protected override void CreateChildControls ()
{
if (FirstTemplate != null)
{
myTemplateContainer = new FirstTemplateContainer(this);
FirstTemplate.InstantiateIn(myTemplateContainer);
Controls.Add(myTemplateContainer);
}
else
{
Controls.Add(new LiteralControl(Text + " " + DateTime));
}
}
5、重写从 Control 继承的 OnDataBinding 方法以调用 EnsureChildControls 方法。这样可保证在页框架尝试计算模板内任何数据绑定表达式之前,创建模板中的子控件。您还必须调用基类的 OnDataBinding 方法以确保调用已注册的事件处理程序。
protected override void OnDataBinding(EventArgs e) {
EnsureChildControls();
base.OnDataBinding(e);
}
7、在步骤 5 中,在 CreateChildControls 方法内重复该逻辑,以便为控件的每个模板属性实例化一个模板。
我们看到,通常情况下我们在模板内指定的Container实际上需要我们控件开发者自行定义。实际上如果不重复生成子控件,InamingContainer也可不实现。但是开始提醒需要实现此接口。如果要在控件中支持数据绑定,那么模板容器应该由一个或者多个属性代表绑定的数据。通常模板类作为控件类的内部私有类实现。
控件可以重复实例化某个模板(只要在不同的容器实例中即可),因此,模板不应该包含或者假定任何控件实例作为成员变量,因为在每次模板实例化时候,成员变量都可以用新的值来重写。
上一页 [1] [2] [C语言系列]NET 中C#的switch语句的语法 [系统软件]托拽Explore中的文件到VB.net的窗口 [系统软件]Boost库在XP+Visual C++.net中的安装 [系统软件]交叉编译sshd for IXP425 ARM Platform by MVL 3… [常用软件]新配色面板:Paint.Net3.0RC1官方下载 [常用软件]用内建的“Net Meeting”聊天 [VB.NET程序]Henry的VB.NET之旅(三)—共享成员 [VB.NET程序]Henry的VB.NET之旅(二)—构造与析构 [VB.NET程序]Henry的VB.NET之旅(一)—失踪的窗体 [VB.NET程序]在托盘上显示Balloon Tooltip(VB.NET)
|