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

Примеры

В следующем примере кода удаляются 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 .

Важно!

Clear Вызов метода не удаляет дескрипторы управления из памяти. Чтобы избежать утечки Dispose памяти, необходимо явно вызвать метод .

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

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

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