ControlCollection.AddAt(Int32, Control) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ArgumentNullException

Parametr child neurčoval ovládací prvek.

ArgumentOutOfRangeException

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

HttpException

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