Control.ControlCollection.AddRange(Control[]) Methode

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

Parameter

Beispiele

Im folgenden Codebeispiel werden der Control abgeleiteten Klasse Control.ControlCollectionzwei Panel Objekte hinzugefügt. Das Beispiel erfordert, dass Sie ein Panel Steuerelement und ein Button Steuerelement für ein Steuerelement Formerstellt haben. Wenn auf die Schaltfläche geklickt wird, werden zwei RadioButton Steuerelemente zum Panel Control.ControlCollectionhinzugefügt.

   // 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

Hinweise

Die Control im controls Array enthaltenen Objekte werden am Ende der Auflistung angefügt.

Mit der AddRange Methode können Sie der Auflistung schnell eine Gruppe von Control Objekten hinzufügen, anstatt jede Control der Auflistung mithilfe der Add Methode manuell hinzuzufügen.

Um ein zuvor hinzugefügtes Element Control zu entfernen, verwenden Sie die RemoveMethoden oder RemoveAtClear Methoden.

Hinweise für Vererber

Achten Sie beim Überschreiben AddRange(Control[]) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse AddRange(Control[]) aufzurufen, um sicherzustellen, dass die Steuerelemente der Auflistung hinzugefügt werden.

Weitere Informationen

• Add(Control)