Control.ControlCollection.Add(Control) 메서드


지정된 컨트롤을 컨트롤 컬렉션에 추가합니다.Adds the specified control to the control collection.

 virtual void Add(System::Windows::Forms::Control ^ value);
public virtual void Add (System.Windows.Forms.Control value);
abstract member Add : System.Windows.Forms.Control -> unit
override this.Add : System.Windows.Forms.Control -> unit
Public Overridable Sub Add (value As Control)

매개 변수


컨트롤 컬렉션에 추가할 Control입니다.The Control to add to the control collection.


지정된 된 컨트롤을 최상위 컨트롤로 되었거나이 컨트롤은 컨트롤 컬렉션에 추가 된 경우 순환 컨트롤 참조가 초래 합니다.The specified control is a top-level control, or a circular control reference would result if this control were added to the control collection.

value 매개 변수에 할당된 개체가 Control이 아닌 경우The object assigned to the value parameter is not a Control.


다음 코드 예제에서는 파생 클래스 PanelControl.ControlCollectionControl를 추가 합니다.The following code example adds a Control to the Control.ControlCollection of the derived class Panel. 이 예제를 사용 하려면 Form에서 Panel 컨트롤과 Button 컨트롤을 만들어야 합니다.The example requires that you have created a Panel control and a Button control on a Form. 단추를 클릭 하면 패널의 Control.ControlCollectionTextBox 컨트롤이 추가 됩니다.When the button is clicked, a TextBox control is added to the panel's Control.ControlCollection.

   // Create a TextBox to add to the Panel.
   TextBox^ textBox1;

   // Add controls to the Panel using the Add method.
   void addButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      textBox1 = gcnew TextBox;
      panel1->Controls->Add( textBox1 );
// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(object sender, System.EventArgs e)
' Create a TextBox to add to the Panel.
Dim TextBox1 As TextBox = New TextBox()

' Add controls to the Panel using the Add method.
Private Sub AddButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles AddButton.Click
End Sub


Add 메서드를 사용 하 여 컨트롤 컬렉션의 끝에 Control 개체를 추가할 수 있습니다.The Add method allows you to add Control objects to the end of the control collection.

AddRange 메서드를 사용 하 여 컬렉션에 새 Control 개체를 추가할 수도 있습니다.You can also add new Control objects to the collection by using the AddRange method.

이전에 추가한 Control를 제거 하려면 Remove, RemoveAt또는 Clear 메서드를 사용 합니다.To remove a Control that you previously added, use the Remove, RemoveAt, or Clear methods.


Control은 한 번에 하나의 Control.ControlCollection에만 할당할 수 있습니다.A Control can only be assigned to one Control.ControlCollection at a time. Control 이미 다른 컨트롤의 자식인 경우 해당 컨트롤에서 다른 컨트롤에 추가 되기 전에 제거 됩니다.If the Control is already a child of another control it is removed from that control before it is added to another control.

상속자 참고

파생 클래스에서 Add(Control)를 재정의 하는 경우 컨트롤을 컬렉션에 추가 하도록 기본 클래스의 Add(Control) 메서드를 호출 해야 합니다.When overriding Add(Control) in a derived class, be sure to call the base class's Add(Control) method to ensure that the control is added to the collection.

적용 대상

추가 정보