Control.ControlCollection.AddRange(Control[]) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Control.ControlCollection.cs

Koleksiyona bir denetim nesneleri dizisi ekler.

public:
 virtual void AddRange(... cli::array <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 (ParamArray controls As Control())

Parametreler

controls

Control[]

Koleksiyona eklenecek nesne dizisi Control .

Örnekler

Aşağıdaki kod örneği, türetilmiş sınıfına ControlControl.ControlCollectioniki Panel nesne ekler. Örnek, üzerinde bir Panel denetim ve bir Button denetim Formoluşturmanızı gerektirir. Düğmeye tıklandığında panelin RadioButtonöğesine iki Control.ControlCollection denetim eklenir.

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

Açıklamalar

Control Dizide controls yer alan nesneler koleksiyonun sonuna eklenir.

yöntemini kullanarak AddRange her Control birini koleksiyona el ile eklemek yerine koleksiyona Control hızla bir nesne grubu Add ekleyebilirsiniz.

Daha önce eklediğiniz bir Control öğesini kaldırmak için , Removeveya RemoveAt yöntemlerini kullanınClear.

Devralanlara Notlar

Türetilmiş bir sınıfta geçersiz kılma AddRange(Control[]) sırasında, denetimlerin koleksiyona eklendiğinden emin olmak için temel sınıfın AddRange(Control[]) yöntemini çağırdığınızdan emin olun.

Ayrıca bkz.

• Add(Control)