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。
示例
下面的代码示例向派生类Panel添加一个 。Control Control.ControlCollection 该示例要求你已创建控件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 控件集合的末尾。
还可以使用AddRange该方法向集合添加新Control对象。
若要删除之前添加的、Control使用Remove或RemoveAtClear方法。
备注
Control一次只能分配给一个Control.ControlCollection。 Control如果该控件已是另一个控件的子级，则会在将控件添加到另一个控件之前将其从该控件中删除。
继承者说明
在 Add(Control) 派生类中重写时，请务必调用基类 Add(Control) 的方法，以确保将控件添加到集合中。