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