Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Control.ControlCollection.Add(Control) Method


コントロール コレクションには、指定したコントロールを追加します。Adds the specified control to the control collection.

 virtual void Add(System::Windows::Forms::Control ^ value);
public virtual void Add (System.Windows.Forms.Control value);
abstract member Add : System.Windows.Forms.Control -> unit
override this.Add : System.Windows.Forms.Control -> unit
Public Overridable Sub Add (value As Control)


Control Control Control Control

Controlコントロール コレクションに追加します。The Control to add to the control collection.


指定したコントロールがトップレベル コントロール、またはこのコントロールがコントロール コレクションに追加された場合に、コントロールの循環参照になります。The specified control is a top-level control, or a circular control reference would result if this control were added to the control collection.

割り当てられているオブジェクト、valueパラメーターではありません、Controlします。The object assigned to the value parameter is not a Control.

次のコード例を追加、ControlControl.ControlCollection派生クラスのPanelします。The following code example adds a Control to the Control.ControlCollection of the derived class Panel. 例では、作成済みである必要があります、PanelコントロールとButtonの control 権限、Formします。The example requires that you have created a Panel control and a Button control on a Form. ボタンがクリックされたときに、TextBoxコントロール パネルのControl.ControlCollectionします。When the button is clicked, a TextBox control is added to the panel's Control.ControlCollection.

   // Create a TextBox to add to the Panel.
   TextBox^ textBox1;

   // Add controls to the Panel using the Add method.
   void addButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
      textBox1 = gcnew TextBox;
      panel1->Controls->Add( textBox1 );
// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(object sender, System.EventArgs e)
  ' Create a TextBox to add to the Panel.
  Dim TextBox1 As TextBox = New TextBox()

  ' Add controls to the Panel using the Add method.
  Private Sub AddButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles AddButton.Click
  End Sub


Addメソッドでは、追加できます。Controlコントロール コレクションの末尾にオブジェクト。The Add method allows you to add Control objects to the end of the control collection.

追加することも新しいControlオブジェクトを使用してコレクションをAddRangeメソッド。You can also add new Control objects to the collection by using the AddRange method.

削除する、Control以前に追加して、使用、 RemoveRemoveAt、またはClearメソッド。To remove a Control that you previously added, use the Remove, RemoveAt, or Clear methods.


AControlいずれかに割り当てることができますのみControl.ControlCollection一度にします。A Control can only be assigned to one Control.ControlCollection at a time. 場合、Controlが既に別のコントロールに追加される前にそのコントロールから削除される別のコントロールの子。If the Control is already a child of another control it is removed from that control before it is added to another control.

注意 (継承者)

オーバーライドするときにAdd(Control)、派生クラスでは、基本クラスを呼び出す、Add(Control)コントロールがコレクションに追加されるようにするメソッド。When overriding Add(Control) in a derived class, be sure to call the base class's Add(Control) method to ensure that the control is added to the collection.