Share via

ControlCollection.Add(Control) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Ajoute l'objet Control spécifié à la collection.

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)

Paramètres

child
Control

Objet Control à ajouter à la collection.

Exceptions

ArgumentNullException

Le paramètre child ne spécifie pas de contrôle.

HttpException

ControlCollection est en lecture seule.

Exemples

L’exemple de code suivant utilise la Add méthode pour ajouter une série d’éléments de modèle, dont le nombre est extrait de l’état d’affichage du contrôle serveur, à un contrôle modèle personnalisé.

// 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

Remarques

Le nouveau contrôle est ajouté à la fin d’un tableau d’index ordinal. Le contrôle peut être une instance de n’importe quel contrôle de serveur ASP.NET, un contrôle serveur personnalisé que vous créez ou un contrôle littéral.

Pour ajouter un contrôle à la collection à un emplacement d’index spécifique, utilisez la AddAt méthode.

S’applique à

Voir aussi