Control.ControlCollection.Add(Control) 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將指定的控制項加入至控制項集合中。

public:
 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)

參數

value

Control

要加入至控制項集合的 Control。

例外狀況

Exception

指定的控制項是最上層控制項，或者這個控制項是加入至控制項集合時，會產生循環控制項參考。

ArgumentException

指定至 value 參數的物件不是 Control。

範例

下列程式碼範例會將 加入 ControlControl.ControlCollection 至衍生類別 Panel 的 。 此範例會要求您已在 上 Form 建立 Panel 控制項和 Button 控制項。 按一下按鈕時， TextBox 控制項會新增至面板的 Control.ControlCollection 。

   // Create a TextBox to add to the Panel.
private:
   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)
{
   panel1.Controls.Add(textBox1);
}

' 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
    Panel1.Controls.Add(TextBox1)
End Sub

備註

方法 Add 可讓您將 物件加入 Control 至控制項集合的結尾。

您也可以使用 AddRange 方法，將新 Control 物件新增至集合。

若要移除您先前新增的 Control ，請使用 Remove 、 RemoveAt 或 Clear 方法。

注意

Control一次只能指派給一個 Control.ControlCollection 。 Control如果 已經是另一個控制項的子系，則會先從該控制項中移除，再將其新增至另一個控制項。

給繼承者的注意事項

在衍生類別中覆 Add(Control) 寫時，請務必呼叫基類 Add(Control) 的 方法，以確保控制項已加入集合中。

另請參閱

• Remove(Control)
• RemoveAt(Int32)
• AddRange(Control[])