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. В примере требуется, чтобы вы создали Panelэлемент управления , а Buttonтакже хотя бы один другой элемент управления 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 элементы управления.

Чтобы добавить новые Control объекты в коллекцию, используйте Add методы или AddRange методы.

Примечания для тех, кто наследует этот метод

При переопределении Clear() в производном классе обязательно вызовите метод базового класса Clear() , чтобы убедиться, что все элементы управления удалены из коллекции.