Control.ControlCollection.Clear Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic Overridable Sub Clear ()Implémente
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.