Control.ControlCollection.Clear Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Supprime tous les contrôles de la collection.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Implémente

Clear()

Exemples

L’exemple de code suivant supprime tous les Control objets de la Control.ControlCollection classe Paneldérivée. L’exemple nécessite que vous ayez créé un , un PanelButtonet au moins un autre contrôle sur un Form. Les autres contrôles sont ajoutés au Panel contrôle et ajoutés Panel à l’élément Form. Lorsque le bouton est cliqué, tous les contrôles contenus dans le panneau sont supprimés de l’élément 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

Remarques

Vous pouvez utiliser la Clear méthode pour supprimer toute la collection de contrôles d’un contrôle parent.

Pour supprimer un contrôle individuel de la collection, utilisez les méthodes ou RemoveAt les Remove méthodes.

Important

L’appel de la Clear méthode ne supprime pas les handles de contrôle de la mémoire. Vous devez appeler explicitement la Dispose méthode pour éviter les fuites de mémoire.

Pour ajouter de nouveaux Control objets à la collection, utilisez les méthodes ou AddRange les Add méthodes.

Notes pour les héritiers

En cas de substitution Clear() dans une classe dérivée, veillez à appeler la méthode de Clear() la classe de base pour vous assurer que tous les contrôles sont supprimés de la collection.