Control.ControlCollection.Clear 메서드

정의

컬렉션에서 모든 컨트롤을 제거합니다.Removes all controls from the collection.

public:
 virtual void Clear();
public virtual void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()

구현

예제

다음 코드 예제에서는 파생 클래스 PanelControl.ControlCollection에서 Control 개체를 모두 제거 합니다.The following code example removes all the Control objects in the Control.ControlCollection of the derived class Panel. 이 예에서는 Panel, ButtonForm에서 하나 이상의 다른 컨트롤을 만들어야 합니다.The example requires that you have created a Panel, a Button, and at least one other control on a Form. 다른 컨트롤은 Panel 컨트롤에 추가 되 고 Panel Form에 추가 됩니다.The other controls are added to the Panel control, and the Panel added to the Form. 단추를 클릭 하면 패널에 포함 된 모든 컨트롤이 Control.ControlCollection에서 제거 됩니다.When the button is clicked, all the controls contained in the panel are removed from the Control.ControlCollection.

   // Clear all the controls in the Panel.
private:
   void clearButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      panel1->Controls->Clear();
   }
// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Clear();
}
' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles ClearButton.Click
    Panel1.Controls.Clear()
End Sub

설명

Clear 메서드를 사용 하 여 부모 컨트롤에서 컨트롤의 전체 컬렉션을 제거할 수 있습니다.You can use the Clear method to remove the entire collection of controls from a parent control.

컬렉션에서 개별 컨트롤을 제거 하려면 Remove 또는 RemoveAt 메서드를 사용 합니다.To remove an individual control from the collection, use the Remove or RemoveAt methods.

중요

Clear 메서드를 호출 해도 메모리에서 컨트롤 핸들이 제거 되지 않습니다.Calling the Clear method does not remove control handles from memory. 메모리 누수를 방지 하려면 Dispose 메서드를 명시적으로 호출 해야 합니다.You must explicitly call the Dispose method to avoid memory leaks.

새로 추가 하려면 Control 컬렉션에 개체를 사용 합니다 Add 또는 AddRange 메서드.To add new Control objects to the collection, use the Add or AddRange methods.

상속자 참고

재정의 하는 경우 Clear() 파생된 클래스에서 호출 해야 기본 클래스의 Clear() 모든 컨트롤 컬렉션에서 제거 되도록 하는 방법입니다.When overriding Clear() in a derived class, be sure to call the base class's Clear() method to ensure that all the controls are removed from the collection.

적용 대상