ControlCollection.Add(Control) Metoda

  • Odwołanie

Definicja

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

Dodaje określony Control obiekt do kolekcji.

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)

Parametry

child
Control

Element Control do dodania do kolekcji.

Wyjątki

ArgumentNullException

Parametr child nie określa kontrolki.

HttpException

Element ControlCollection jest tylko do odczytu.

Przykłady

W poniższym przykładzie kodu użyto Add metody , aby dodać serię elementów szablonu, z których liczba jest pobierana ze stanu widoku kontrolki serwera, do niestandardowej kontrolki szablonu.

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

Uwagi

Nowa kontrolka jest dodawana na końcu tablicy indeksów porządkowych. Kontrolka może być wystąpieniem dowolnej kontrolki serwera ASP.NET, niestandardowej kontrolki serwera lub kontrolki literału.

Aby dodać kontrolkę do kolekcji w określonej lokalizacji indeksu AddAt , użyj metody .

Dotyczy

Zobacz też