ControlCollection.Add(Control) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

将指定的 Control 对象添加到集合。

public:
 virtual void Add(System::Web::UI::Control ^ child);

public virtual void Add (System.Web.UI.Control child);

abstract member Add : System.Web.UI.Control -> unit
override this.Add : System.Web.UI.Control -> unit

Public Overridable Sub Add (child As Control)

参数

child

Control

要添加到集合中的 Control。

例外

ArgumentNullException

child 参数不指定控件。

HttpException

ControlCollection 为只读。

示例

下面的代码示例使用 Add 该方法将一系列模板项（从服务器控件的视图状态获取的模板项数）添加到自定义模板化控件。

// Override to create repeated items.
protected override void CreateChildControls() {
    object o = ViewState["NumItems"];
    if (o != null) {
       // Clear any existing child controls.
       Controls.Clear();

       int numItems = (int)o;
       for (int i=0; i < numItems; i++) {
          // Create an item.
          RepeaterItem item = new RepeaterItem(i, null);
          // Initialize the item from the template.
          ItemTemplate.InstantiateIn(item);
          // Add the item to the ControlCollection.
          Controls.Add(item);
       }
    }
}

' Override to create repeated items.
Protected Overrides Sub CreateChildControls()
    Dim O As Object = ViewState("NumItems")
    If Not (O Is Nothing)
       ' Clear any existing child controls.
       Controls.Clear()

       Dim I As Integer
       Dim NumItems As Integer = CInt(O)
       For I = 0 To NumItems - 1
          ' Create an item.
          Dim Item As RepeaterItemVB = New RepeaterItemVB(I, Nothing)
          ' Initialize the item from the template.
          ItemTemplate.InstantiateIn(Item)
          ' Add the item to the ControlCollection.
          Controls.Add(Item)
       Next
    End If
End Sub

注解

新控件将添加到序号索引数组的末尾。 该控件可以是任何 ASP.NET 服务器控件、你创建的自定义服务器控件或文本控件的实例。

若要将控件添加到集合中的特定索引位置，请使用 AddAt 该方法。

另请参阅

• Controls
• AddAt(Int32, Control)