ControlCollection.AddAt(Int32, Control) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Aggiunge l'oggetto Control specificato all'insieme nella posizione di indice specificata.

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)

Parametri

index
Int32

Posizione all'interno della matrice in corrispondenza della quale deve essere aggiunto il controllo figlio.

child
Control

Oggetto Control da aggiungere alla raccolta.

Eccezioni

ArgumentNullException

Il parametro child non specifica un controllo.

ArgumentOutOfRangeException

Il parametro index è minore di zero o maggiore della proprietà Count.

HttpException

La classe ControlCollection è di sola lettura.

Esempio

Nell'esempio di codice seguente viene utilizzato il AddAt metodo per creare un nuovo LiteralControl oggetto denominato ChildControl2 e aggiungerlo alla myButton raccolta del ControlCollection controllo nella posizione di indice 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))

Commenti

Il controllo aggiunto può essere un'istanza di qualsiasi controllo server ASP.NET, un controllo server personalizzato creato o un controllo letterale.

Si applica a

Vedi anche