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

コントロール コレクションに追加する ControlThe 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.

次のコード例では、派生クラス Panel の @no__t に Control を追加します。The following code example adds a Control to the Control.ControlCollection of the derived class Panel. この例では、Form で @no__t 0 コントロールと @no__t 1 コントロールを作成しておく必要があります。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, 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


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

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

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


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

注意 (継承者)

派生クラスで @no__t 0 をオーバーライドする場合は、必ず基底クラスの @no__t メソッドを呼び出して、コントロールが確実にコレクションに追加されるようにしてください。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.