ControlCollection.Add-Methode

Artikel
08/20/2007

Fügt der Auflistung das angegebene Control-Objekt hinzu.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Sub Add ( _
    child As Control _
)
'Usage
Dim instance As ControlCollection
Dim child As Control

instance.Add(child)

public virtual void Add (
    Control child
)

public:
virtual void Add (
    Control^ child
)

public void Add (
    Control child
)

public function Add (
    child : Control
)

Parameter

child
Das der Auflistung hinzuzufügende Control.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Wird ausgelöst, wenn der child-Parameter kein Steuerelement angibt.
HttpException	Wird ausgelöst, wenn ControlCollection schreibgeschützt ist.

Hinweise

Das neue Steuerelement wird am Ende eines Ordinalindexarrays hinzugefügt. Das Steuerelement kann eine Instanz eines beliebigen ASP.NET-Serversteuerelements, ein selbst erstelltes Serversteuerelement oder ein Textsteuerelement sein.

Mithilfe der AddAt-Methode wird ein Steuerelement der Auflistung an einer bestimmten Indexposition hinzugefügt.

Beispiel

Im folgenden Codebeispiel werden einer benutzerdefinierten Steuerelementvorlage mithilfe der Add-Methode eine Reihe von Vorlagenelementen hinzugefügt. Die Anzahl wird dabei dem Ansichtszustand des Serversteuerelements entnommen.

' 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

// 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 void CreateChildControls()
{
    Object o = get_ViewState().get_Item("NumItems");
    if (o != null) {
        // Clear any existing child controls.
        get_Controls().Clear();

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ControlCollection-Klasse
ControlCollection-Member
System.Web.UI-Namespace
Control.Controls-Eigenschaft
AddAt

Freigeben über