ControlCollection.Add(Control) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá zadaný Control objekt do kolekce.

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)

Parametry

child: Control

Přidání Control do kolekce

Výjimky

ArgumentNullException

Parametr child neurčoval ovládací prvek.

HttpException

Je ControlCollection jen pro čtení.

Příklady

Následující příklad kódu používá metodu Add k přidání řady položek šablony, které jsou převzaty ze stavu zobrazení ovládacího prvku serveru, do vlastního ovládacího prvku šablony.

// 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

Poznámky

Nový ovládací prvek se přidá na konec pořadového pole indexu. Ovládací prvek může být instancí libovolného ovládacího prvku serveru ASP.NET, vlastního ovládacího prvku serveru, který vytvoříte, nebo literálového ovládacího prvku.

Pokud chcete přidat ovládací prvek do kolekce v určitém umístění indexu, použijte metodu AddAt .

Platí pro

Sdílet prostřednictvím