Control.ControlCollection.Clear Control.ControlCollection.Clear Control.ControlCollection.Clear Control.ControlCollection.Clear Method

Определение

Удаляет все элементы управления из коллекции.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 методы или. RemoveAtTo 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.

Применяется к