自定义控件的构建(8)

在前面的几节基础上,现在我们开始涉足构建对象集合的控件,以GridView而言,其内部就包含了多个DataBoundField控件来表示所要显示的各个列。

首先了解名为ParseChildren的特性,其用来决定如何解析控件包含的内容:值为True时,控件所包含的内容将作为控件的属性解析,若该控件包含子控件,

则该子控件将作为外围控件的属性进行解析;当值为False时,则控件包含的内容将独立解析,且子控件将不作为属性解析。

下面则创建在ParseChildren为Ture和False的不同情况下的一个自定义控件,其功能用于页面中随机显示内容。

    [ParseChildren(false)]
    public class RotatorsContentControl:WebControl
    {
        protected override void AddParsedSubObject(object obj)
        {
            if (obj is Content)
            {
                base.AddParsedSubObject(obj);
            }
        }
        protected override void RenderContents(HtmlTextWriter writer)
        {
            Random random = new Random();
            int x = this.Controls.Count;
            int index = random.Next(x);
            this.Controls[0].RenderControl(writer);
        }
    }
public class Content:Control
    { 
    }

上面的代码中实际包含了2个控件,Content和RotatorsContentControl控件,后者从其子控件中随机选择一个Content控件并呈现在浏览器中,

注意这里的ParseChildren值为False,如果未添加该属性,Content控件将被当做RotatorsContentControl的一个属性来解析,这样会产生一个异常。

演示的关键代码:

     <myControl:RotatorsContentControl ID="RotatorsContentControl1" runat="server">
     <myControl:Content ID="Content1"  runat="server">This is an apple!</myControl:Content>
     <myControl:Content ID="Content2" runat="server">This is an apple,too!
         <asp:Button ID="Button1" runat="server" Text="Button" />
     </myControl:Content>
     <myControl:Content ID="Content3" runat="server">This is a  banana,too!</myControl:Content>
     </myControl:RotatorsContentControl>
如果ParseChildren的值为True,则要为控件添加一个引用子控件的属性。
  [ParseChildren(true,"Items")]
    public class ItemControl : Control
    {
        private ArrayList array = new ArrayList();
        [Browsable(false)]
        public ArrayList Items
        {
            get { return array; }
        }
        protected override void CreateChildControls()
        {
            Random random = new Random();
            int index = random.Next(array.Count);
            Control item = (Control)array[index];
            this.Controls.Add(item);
        }
    }
    public class Item : Control
    {
    }
     

ParseChildren的第二个参数是控件属性的名字,上面的代码设计了一个Items属性表示控件所包含的控件项。与第一个示例不同的是,这里ItemRotator控件

内所包含的控件不会自动的解析成子控件,在CreatChildControl()运行后,该控件仅包含一个子控件

演示:

 <myControl:ItemControl ID="ItemControl1" runat="server">
     <myControl:Item ID="Item1" runat="server">A
     </myControl:Item>
     <myControl:Item ID="Item2" runat="server">B
     </myControl:Item>
     <myControl:Item ID="Item3" runat="server">C
     </myControl:Item>
    </myControl:ItemControl>
事实上,控件的内容可不必解析成控件,在创建表示项集合的控件时,也可以把项表示成对象。
public class Images
    {
     
        public string Url
        {
            get;set;
        }
        public string Text
        {
            get;
            set;
        }
    }
    [ParseChildren(true, "Items")]
    public class ImageRotator : WebControl
    {
        private ArrayList array = new ArrayList();
        [Browsable(false)]
        public ArrayList Items
        {
            get { return array; }
        }
        protected override void RenderContents(HtmlTextWriter writer) 
        {
            if (array.Count > 0)
            {
                Random random = new Random();
                Images image =(Images) array[random.Next(array.Count)];
                writer.AddAttribute(HtmlTextWriterAttribute.Src, image.Url);
                writer.AddAttribute(HtmlTextWriterAttribute.Alt, image.Text);
                writer.RenderBeginTag(HtmlTextWriterTag.Img);
                writer.RenderEndTag();
            }
        }
    }

注意这里的细微变化,Images仅仅是个类,并未从任何控件基类继承。可以看看界面中如何使用这个控件的

  <myControl:ImageRotator ID="ImageRotator1" runat="server">
    <myControl:Images  Text="image1" />
    <myControl:Images  Text="image2" />
    <myControl:Images  Text="image3" />
    </myControl:ImageRotator>
将页面的Trace打开,可以发现其中的ImageRotator1中并未包含任何子控件

 

 

 

本文参考了《ASP.NET 3.5揭秘》

posted @ 2010-08-05 08:18  ringgo  阅读(544)  评论(2编辑  收藏  举报