Udostępnij za pośrednictwem

ControlCollection.AddAt(Int32, Control) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

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

Zobacz też