ControlCollection.AddAt(Int32, Control) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

public:
 virtual void AddAt(int index, System::Web::UI::Control ^ child);

public virtual void AddAt (int index, System.Web.UI.Control child);

abstract member AddAt : int * System.Web.UI.Control -> unit
override this.AddAt : int * System.Web.UI.Control -> unit

Public Overridable Sub AddAt (index As Integer, child As Control)

Parameter

index

Int32

Die Position im Array, an der das untergeordnete Steuerelement hinzugefügt werden soll

child

Control

Der der Auflistung hinzuzufügende Control.

Ausnahmen

ArgumentNullException

Der child-Parameter gibt kein Steuerelement an.

ArgumentOutOfRangeException

Der index-Parameter ist kleiner als 0 (null) oder größer als die Count-Eigenschaft.

HttpException

ControlCollection ist schreibgeschützt.

Beispiele

Im folgenden Codebeispiel wird die AddAt -Methode verwendet, um einen neuen LiteralControl Namen ChildControl2 zu erstellen und der myButton Auflistung des Steuerelements ControlCollection an der Indexposition von 1 hinzuzufügen.

// 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.
LiteralControl myLiteralControl = 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));

' 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))

Hinweise

Das hinzugefügte Steuerelement kann eine Instanz eines beliebigen ASP.NET Serversteuerelements, ein von Ihnen erstelltes benutzerdefiniertes Serversteuerelement oder ein Literalsteuerelement sein.

Weitere Informationen

• Controls
• Add(Control)