Control.ControlCollection.Clear Méthode

Définition

Supprime tous les contrôles de la collection.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 ()

Implémente

Exemples

L’exemple de code suivant supprime tous les objets Control dans le Control.ControlCollection de la classe dérivée Panel.The following code example removes all the Control objects in the Control.ControlCollection of the derived class Panel. L’exemple requiert que vous ayez créé un Panel, un Buttonet au moins un autre contrôle sur un Form.The example requires that you have created a Panel, a Button, and at least one other control on a Form. Les autres contrôles sont ajoutés au contrôle Panel et le Panel ajouté au Form.The other controls are added to the Panel control, and the Panel added to the Form. Lorsque l’utilisateur clique sur le bouton, tous les contrôles contenus dans le panneau sont supprimés du 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

Remarques

Vous pouvez utiliser la méthode Clear pour supprimer l’intégralité de la collection de contrôles d’un contrôle parent.You can use the Clear method to remove the entire collection of controls from a parent control.

Pour supprimer un contrôle individuel de la collection, utilisez les méthodes Remove ou RemoveAt.To remove an individual control from the collection, use the Remove or RemoveAt methods.

Important

L’appel de la méthode Clear ne supprime pas les handles de contrôle de la mémoire.Calling the Clear method does not remove control handles from memory. Vous devez appeler explicitement la méthode Dispose pour éviter les fuites de mémoire.You must explicitly call the Dispose method to avoid memory leaks.

Pour ajouter de nouveaux objets Control à la collection, utilisez les méthodes Add ou AddRange.To add new Control objects to the collection, use the Add or AddRange methods.

Notes pour les héritiers

Lors de la substitution d' Clear() dans une classe dérivée, veillez à appeler la méthode Clear() de la classe de base pour vous assurer que tous les contrôles sont supprimés de la collection.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.

S’applique à