Control.ControlCollection.AddRange(Control[]) 方法

定义

将控件对象数组添加到集合中。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.

示例

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

注解

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

你可以使用 AddRange 方法将一组 @no__t 的对象快速添加到集合,而不是使用 Add 方法将每个 Control 手动添加到集合中。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.

若要删除先前添加的 @no__t 0,请使用 @no__t、RemoveAt 或 @no__t 3 方法。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.

适用于

另请参阅