ControlCollection.AddAt-Methode

Artikel
08/20/2007

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

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

Syntax

'Declaration
Public Overridable Sub AddAt ( _
    index As Integer, _
    child As Control _
)
'Usage
Dim instance As ControlCollection
Dim index As Integer
Dim child As Control

instance.AddAt(index, child)

public virtual void AddAt (
    int index,
    Control child
)

public:
virtual void AddAt (
    int index, 
    Control^ child
)

public void AddAt (
    int index, 
    Control child
)

public function AddAt (
    index : int, 
    child : Control
)

Parameter

index
Die Position im Array, an der das untergeordnete Steuerelement hinzugefügt wird.

child
Das der Auflistung hinzuzufügende Control.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der child-Parameter gibt kein Steuerelement an.
ArgumentOutOfRangeException	Der index-Parameter ist kleiner als 0 (null) oder größer als die ControlCollection.Count-Eigenschaft.
HttpException	ControlCollection ist schreibgeschützt.

Hinweise

Das hinzugefügte Steuerelement kann eine Instanz eines beliebigen ASP.NET-Serversteuerelements, ein selbst erstelltes Serversteuerelement oder ein Textsteuerelement sein.

Beispiel

Im folgenden Codebeispiel wird mit der AddAt-Methode das neue LiteralControl mit dem Namen ChildControl2 erstellt und der ControlCollection-Auflistung des myButton-Steuerelements an der Indexposition 1 hinzugefügt.

' Create a LiteralControl and use the Add method to add it
' to a button's ControlCollection, then use the AddAt method
' to add another LiteralControl to the collection at the
' index location of 1.
Dim myLiteralControl As LiteralControl =  _
    new LiteralControl("ChildControl1")
myButton.Controls.Add(myLiteralControl)
myButton.Controls.AddAt(1,new LiteralControl("ChildControl2"))
Response.Write("<b>ChildControl2 is added at index 1</b>")

' Get the Index location of the myLiteralControl LiteralControl
' and write it to the page.
Response.Write("<br><b>Index of the ChildControl myLiteralControl is </b>" & _
                 myButton.Controls.IndexOf(myLiteralControl))

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
Add

Freigeben über