ControlCollection.Add(Control) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Hiermee voegt u het opgegeven Control object toe aan de verzameling.

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)

Parameters

child
Control

De Control toe te voegen aan de verzameling.

Uitzonderingen

ArgumentNullException

De child parameter geeft geen besturingselement op.

HttpException

Het ControlCollection is alleen-lezen.

Voorbeelden

In het volgende codevoorbeeld wordt de Add methode gebruikt om een reeks sjabloonitems toe te voegen, waarvan het aantal items wordt opgehaald uit de weergavestatus van het serverbeheer, aan een aangepast besturingselement met sjabloon.

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

Opmerkingen

Het nieuwe besturingselement wordt toegevoegd aan het einde van een ordinale indexmatrix. Het besturingselement kan een exemplaar zijn van elk ASP.NET serverbeheer, een aangepast serverbeheer dat u maakt of een letterlijk besturingselement.

Als u een besturingselement wilt toevoegen aan de verzameling op een specifieke indexlocatie, gebruikt u de AddAt methode.

Van toepassing op

Zie ook