Control.ControlCollection.AddRange(Control[]) Méthode

public:
 virtual void AddRange(cli::array <System::Windows::Forms::Control ^> ^ controls);

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::Control ^> ^ controls);

public virtual void AddRange (System.Windows.Forms.Control[] controls);

public virtual void AddRange (params System.Windows.Forms.Control[] controls);

abstract member AddRange : System.Windows.Forms.Control[] -> unit
override this.AddRange : System.Windows.Forms.Control[] -> unit

Public Overridable Sub AddRange (controls As Control())

Public Overridable Sub AddRange (ParamArray controls As Control())

Paramètres

Exemples

L’exemple de code suivant ajoute deux Control objets au Control.ControlCollection de la classe Paneldérivée . L’exemple nécessite que vous ayez créé un Panel contrôle et un Button contrôle sur un Form. Lorsque vous cliquez sur le bouton, deux RadioButton contrôles sont ajoutés au panneau .Control.ControlCollection

   // Create two RadioButtons to add to the Panel.
private:
   RadioButton^ radioAddButton;
   RadioButton^ radioRemoveButton;

   // Add controls to the Panel using the AddRange method.
   void addRangeButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      radioAddButton = gcnew RadioButton;
      radioRemoveButton = gcnew RadioButton;
      
      // Set the Text the RadioButtons will display.
      radioAddButton->Text = "radioAddButton";
      radioRemoveButton->Text = "radioRemoveButton";
      
      // Set the appropriate location of radioRemoveButton.
      radioRemoveButton->Location = System::Drawing::Point( radioAddButton->Location.X, radioAddButton->Location.Y + radioAddButton->Height );
      
      //Add the controls to the Panel.
      array<Control^>^controlArray = {radioAddButton,radioRemoveButton};
      panel1->Controls->AddRange( controlArray );
   }

// Create two RadioButtons to add to the Panel.
private RadioButton radioAddButton = new RadioButton();
private RadioButton radioRemoveButton = new RadioButton();

// Add controls to the Panel using the AddRange method.
private void addRangeButton_Click(object sender, System.EventArgs e)
{
   // Set the Text the RadioButtons will display.
   radioAddButton.Text = "radioAddButton";
   radioRemoveButton.Text = "radioRemoveButton";
            
   // Set the appropriate location of radioRemoveButton.
   radioRemoveButton.Location = new System.Drawing.Point(
     radioAddButton.Location.X, 
     radioAddButton.Location.Y + radioAddButton.Height);
            
   //Add the controls to the Panel.
   panel1.Controls.AddRange(new Control[]{radioAddButton, radioRemoveButton});
}

' Create two RadioButtons to add to the Panel.
Dim RadioAddButton As RadioButton = New RadioButton()
Dim RadioAddRangeButton As RadioButton = New RadioButton()

' Add controls to the Panel using the AddRange method.
Private Sub AddRangeButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles AddRangeButton.Click
    ' Set the Text the RadioButtons will display.
    RadioAddButton.Text = "RadioAddButton"
    RadioAddRangeButton.Text = "RadioAddRangeButton"

    ' Set the appropriate location of RadioAddRangeButton.
    RadioAddRangeButton.Location = New System.Drawing.Point( _
    RadioAddButton.Location.X, _
    RadioAddButton.Location.Y + RadioAddButton.Height)

    ' Add the controls to the Panel.
    Panel1.Controls.AddRange(New Control() {RadioAddButton, RadioAddRangeButton})
End Sub

Remarques

Les Control objets contenus dans le controls tableau sont ajoutés à la fin de la collection.

Vous pouvez utiliser la AddRange méthode pour ajouter rapidement un groupe d’objets Control à la collection au lieu d’ajouter manuellement chacun Control à la collection à l’aide de la Add méthode .

Pour supprimer un Control que vous avez ajouté précédemment, utilisez les Removeméthodes , RemoveAtou Clear .

Notes pour les héritiers

Lors de la AddRange(Control[]) substitution dans une classe dérivée, veillez à appeler la méthode de la classe de AddRange(Control[]) base pour vous assurer que les contrôles sont ajoutés à la collection.

S’applique à

Voir aussi

• Add(Control)