Form.ControlCollection.Add Method (Control)

 

Adds a control to the form.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public override void Add(
	Control value
)

Parameters

value
Type: System.Windows.Forms.Control

The Control to add to the form.

Exception Condition
Exception

A multiple document interface (MDI) parent form cannot have controls added to it.

You can use this method to add controls to the form. If you want to add a group of already created controls to the form, use the Control.ControlCollection.AddRange method of the Control.ControlCollection class.

The following code example adds a TextBox and Label control to the control collection of a form. The example requires that a form has been created and named Form1.

public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();

    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);

    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }

.NET Framework
Available since 1.1
Return to top
Show: