ControlCollection.AddAt(Int32, Control) Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Добавляет указанный объект Control в коллекцию по указанному расположению индекса.

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)

Параметры

index

Int32

Расположение в массиве, куда добавляется дочерний элемент управления.

child

Control

Параметр Control для добавления в коллекцию.

Исключения

ArgumentNullException

Параметр child не определяет элемент управления.

ArgumentOutOfRangeException

Параметр index меньше нуля или больше значения свойства Count.

HttpException

Объект ControlCollection доступен только для чтения.

Примеры

В следующем примере кода метод используется AddAt для создания именованного объекта ChildControl2 LiteralControl и добавления его в myButton коллекцию элемента управления ControlCollection в расположении индекса 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))

Комментарии

Добавленный элемент управления может быть экземпляром любого ASP.NET серверного элемента управления, настраиваемого серверного элемента управления или литерального элемента управления.

См. также раздел

• Controls
• Add(Control)