ControlCollection.Add(Control) Metodo

  • Riferimento

Definizione

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

Aggiunge l'oggetto Control specificato alla raccolta.

public:
 virtual void Add(System::Web::UI::Control ^ child);
public virtual void Add (System.Web.UI.Control child);
abstract member Add : System.Web.UI.Control -> unit
override this.Add : System.Web.UI.Control -> unit
Public Overridable Sub Add (child As Control)

Parametri

child
Control

Oggetto Control da aggiungere alla raccolta.

Eccezioni

ArgumentNullException

Il parametro child non specifica un controllo.

HttpException

La classe ControlCollection è di sola lettura.

Esempio

Nell'esempio di codice seguente viene usato il Add metodo per aggiungere una serie di elementi del modello, il numero di quali vengono presi dallo stato di visualizzazione del controllo server, a un controllo personalizzato con modelli.

// Override to create repeated items.
protected override void CreateChildControls() {
    object o = ViewState["NumItems"];
    if (o != null) {
       // Clear any existing child controls.
       Controls.Clear();

       int numItems = (int)o;
       for (int i=0; i < numItems; i++) {
          // Create an item.
          RepeaterItem item = new RepeaterItem(i, null);
          // Initialize the item from the template.
          ItemTemplate.InstantiateIn(item);
          // Add the item to the ControlCollection.
          Controls.Add(item);
       }
    }
}

' Override to create repeated items.
Protected Overrides Sub CreateChildControls()
    Dim O As Object = ViewState("NumItems")
    If Not (O Is Nothing)
       ' Clear any existing child controls.
       Controls.Clear()

       Dim I As Integer
       Dim NumItems As Integer = CInt(O)
       For I = 0 To NumItems - 1
          ' Create an item.
          Dim Item As RepeaterItemVB = New RepeaterItemVB(I, Nothing)
          ' Initialize the item from the template.
          ItemTemplate.InstantiateIn(Item)
          ' Add the item to the ControlCollection.
          Controls.Add(Item)
       Next
    End If
End Sub

Commenti

Il nuovo controllo viene aggiunto alla fine di una matrice di indici ordinali. Il controllo può essere un'istanza di qualsiasi controllo server ASP.NET, un controllo server personalizzato creato o un controllo letterale.

Per aggiungere un controllo alla raccolta in una posizione di indice specifica, usare il AddAt metodo .

Si applica a

Vedi anche