Control.ControlCollection.Clear 메서드

정의

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

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

구현

예제

다음 코드 예제에서는 파생 클래스Control의 모든 Control.ControlCollection 개체를 제거 합니다Panel. 이 예제에서는 에 대해 , a PanelButton및 하나 이상의 다른 컨트롤을 만들어야 합니다Form. 다른 컨트롤이 컨트롤에 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 사용하여 부모 컨트롤에서 컨트롤의 전체 컬렉션을 제거할 수 있습니다.

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

Important

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

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

상속자 참고

파생 클래스에서 재정 Clear() 의하는 경우 기본 클래스의 Clear() 메서드를 호출하여 모든 컨트롤이 컬렉션에서 제거되도록 해야 합니다.

적용 대상