ControlCollection.AddAt(Int32, Control) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dodaje określony Control obiekt do kolekcji w określonej lokalizacji indeksu.

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

Lokalizacja w tablicy, w której ma zostać dodana kontrolka podrzędna.

child: Control

Element Control do dodania do kolekcji.

Wyjątki

ArgumentNullException

Parametr child nie określa kontrolki.

ArgumentOutOfRangeException

Parametr index jest mniejszy niż zero lub większy niż Count właściwość .

HttpException

Element ControlCollection jest tylko do odczytu.

Przykłady

W poniższym przykładzie kodu użyto AddAt metody , aby utworzyć nową LiteralControl nazwę ChildControl2 i dodać ją do myButton kolekcji kontrolki ControlCollection w lokalizacji indeksu 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))

Uwagi

Dodana kontrolka może być wystąpieniem dowolnej kontrolki serwera ASP.NET, niestandardowej kontrolki serwera lub kontrolki literału.

Dotyczy