ControlCollection.Add(Control) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

Belirtilen Control nesneyi koleksiyona ekler.

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)

Parametreler

child
Control

Control koleksiyonuna eklenecek öğesini seçin.

Özel durumlar

ArgumentNullException

child parametresi bir denetim belirtmez.

HttpException

ControlCollection salt okunurdur.

Örnekler

Aşağıdaki kod örneği, sayısı sunucu denetiminin görünüm durumundan alınan bir dizi şablon öğesini özel şablonlu denetime eklemek için yöntemini kullanır Add .

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

Açıklamalar

Yeni denetim, sıralı dizin dizisinin sonuna eklenir. Denetim herhangi bir ASP.NET sunucu denetiminin örneği, oluşturduğunuz özel bir sunucu denetimi veya değişmez değer denetimi olabilir.

Belirli bir dizin konumundaki koleksiyona denetim eklemek için yöntemini kullanın AddAt .

Şunlara uygulanır

Ayrıca bkz.