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 ()

구현

예제

다음 코드 예제에서는 Control 파생 클래스의에서 모든 개체를 제거 합니다 Control.ControlCollection Panel .The following code example removes all the Control objects in the Control.ControlCollection of the derived class Panel. 이 예제를 사용 하려면에 Panel , Button 및 하나 이상의 다른 컨트롤을 만들어야 Form 합니다.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.

적용 대상