Sdílet prostřednictvím


ControlCollection.AddAt(Int32, Control) Metoda

Definice

Přidá zadaný Control objekt do kolekce v zadaném umístění indexu.

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)

Parametry

index
Int32

Umístění v poli, do kterého chcete přidat podřízený ovládací prvek.

child
Control

Přidání Control do kolekce

Výjimky

Parametr child neurčoval ovládací prvek.

Parametr index je menší než nula nebo větší než Count vlastnost.

Je ControlCollection jen pro čtení.

Příklady

Následující příklad kódu používá metodu AddAt k vytvoření nového LiteralControl pojmenovaného ChildControl2 a přidání do myButton kolekce ovládacího prvku ControlCollection v umístění indexu 1.

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

Poznámky

Přidaným ovládacím prvku může být instance 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.

Platí pro

Viz také