Control.ControlCollection.AddRange(Control[]) Control.ControlCollection.AddRange(Control[]) Control.ControlCollection.AddRange(Control[]) Control.ControlCollection.AddRange(Control[]) Method

定义

将控件对象数组添加到集合中。Adds an array of control objects to the collection.

public:
 virtual void AddRange(cli::array <System::Windows::Forms::Control ^> ^ controls);
public virtual void AddRange (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())

参数

controls
Control[]

要添加到集合中的 Control 对象的数组。An array of Control objects to add to the collection.

示例

下面的代码示例将两Control个对象添加Control.ControlCollection到派生类Panel的。The following code example adds two Control objects to the Control.ControlCollection of the derived class Panel. 该示例要求您已经在Panel Form中创建了一个控件Button和一个控件。The example requires that you have created a Panel control and a Button control on a Form. 单击该按钮时,会将RadioButton两个控件添加到面板的Control.ControlCollection中。When the button is clicked, two RadioButton controls are added to the panel's 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

注解

数组中包含的Control对象将追加到集合controls的末尾。The Control objects contained in the controls array are appended to the end of the collection.

可以使用AddRange方法将一Control组对象快速添加到集合, Control而不是使用Add方法手动将它们添加到集合中。You can use the AddRange method to quickly add a group of Control objects to the collection instead of manually adding each Control to the collection using the Add method.

若要删除Control先前添加的,请Remove使用、 RemoveAtClear方法。To remove a Control that you previously added, use the Remove, RemoveAt, or Clear methods.

继承者说明

当在AddRange(Control[])派生类中重写时,请确保调用基类的AddRange(Control[])方法,以确保将控件添加到集合中。When overriding AddRange(Control[]) in a derived class, be sure to call the base class's AddRange(Control[]) method to ensure that the controls are added to the collection.

适用于

另请参阅