Control.ControlCollection.Clear 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

컬렉션에서 컨트롤을 모두 제거합니다.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

구현

Clear()

예제

다음 코드 예제에서는 파생 클래스Panel의 모든 Control 개체를 제거합니다Control.ControlCollection. 이 예제에서는 에 대해 하나 이상의 다른 컨트롤Form을 Button만들어야 Panel합니다. 다른 컨트롤이 컨트롤에 Panel 추가되고 컨트롤에 Panel 추가됩니다 Form. 단추를 클릭하면 패널에 포함된 모든 컨트롤이 제거됩니다 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 사용하여 부모 컨트롤에서 컨트롤의 전체 컬렉션을 제거할 수 있습니다.

컬렉션에서 개별 컨트롤을 제거하려면 또는 RemoveAt 메서드를 Remove 사용합니다.

중요

메서드를 호출해 Clear 도 메모리에서 컨트롤 핸들이 제거되지 않습니다. 메모리 누수가 발생하지 않도록 메서드를 Dispose 명시적으로 호출해야 합니다.

새로 추가 하려면 Control 컬렉션에 개체를 사용 합니다 Add 또는 AddRange 메서드.

상속자 참고

재정의 하는 경우 Clear() 파생된 클래스에서 호출 해야 기본 클래스의 Clear() 모든 컨트롤 컬렉션에서 제거 되도록 하는 방법입니다.