ControlCollection.Add(Control) 메서드

정의

네임스페이스:

System.Web.UI

어셈블리:

System.Web.dll

지정된 Control 개체를 컬렉션에 추가합니다.

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)

매개 변수

child

Control

컬렉션에 추가할 Control입니다.

예외

ArgumentNullException

child 매개 변수가 컨트롤을 지정하지 않는 경우

HttpException

ControlCollection이 읽기 전용인 경우

예제

다음 코드 예제에서는 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

설명

새 컨트롤의 서 수 인덱스 배열 끝에 추가 됩니다. 컨트롤에는 모든 ASP.NET 서버 컨트롤, 사용자 지정 서버 컨트롤을 만든 또는 리터럴 컨트롤의 인스턴스일 수 있습니다.

특정 인덱스 위치의 컬렉션에 컨트롤을 추가 하려면 사용 된 AddAt 메서드.

추가 정보

• Controls
• AddAt(Int32, Control)