Control.ControlCollection.Add(Control) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將指定的控制項加入控制集合。
public:
virtual void Add(System::Windows::Forms::Control ^ value);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 -> unitPublic Overridable Sub Add (value As Control)參數
例外狀況
指定的控制是頂層控制，若將此控制加入控制集合，則會產生一個圓形控制參考。
分配給參數 value 的物件並非 Control。
範例
以下程式碼範例將 a Control 加入 Control.ControlCollection 衍生類別 Panel的 。 範例要求你建立了一個Panel控制點，且在 上Button建立了一個Form控制點。 當按鈕被點擊時， 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 控制集合的末端。
你也可以用這個Control方法新增AddRange物件到集合裡。
要移除你之前新增的 ， Control 請使用 Remove、 RemoveAt或 Clear 方法。
Note
A Control 一次只能分配給一個 Control.ControlCollection 。 如果 已經 Control 是另一個控制項的子控制項，則會在加入其他控制項前將其從該控制項移除。
給繼承者的注意事項
在導出類別中覆 Add(Control) 寫時，務必呼叫基底類別的方法 Add(Control) ，確保控制項被加入集合中。
