Control.ControlCollection.Add(Control) Método

Definición

Agrega el control especificado a la colección de controles.Adds the specified control to the control collection.

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)

Parámetros

value
Control

Control que se va a agregar a la colección.The Control to add to the control collection.

Excepciones

El control especificado es de nivel superior o se producirá una referencia circular a un control si éste se agregó a la colección de controles.The specified control is a top-level control, or a circular control reference would result if this control were added to the control collection.

El objeto asignado al parámetro value no es un Control.The object assigned to the value parameter is not a Control.

Ejemplos

En el ejemplo de código siguiente se agrega un Control al Control.ControlCollection de la clase derivada Panel.The following code example adds a Control to the Control.ControlCollection of the derived class Panel. El ejemplo requiere que se haya creado un control Panel y un control Button en un Form.The example requires that you have created a Panel control and a Button control on a Form. Al hacer clic en el botón, se agrega un control de TextBox al Control.ControlCollectiondel panel.When the button is clicked, a TextBox control is added to the panel's 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

Comentarios

El método Add permite agregar objetos Control al final de la colección de controles.The Add method allows you to add Control objects to the end of the control collection.

También puede agregar nuevos objetos Control a la colección mediante el método AddRange.You can also add new Control objects to the collection by using the AddRange method.

Para quitar una Control agregada anteriormente, use los métodos Remove, RemoveAto Clear.To remove a Control that you previously added, use the Remove, RemoveAt, or Clear methods.

Nota

Un Control solo se puede asignar a un Control.ControlCollection cada vez.A Control can only be assigned to one Control.ControlCollection at a time. Si el Control ya es un elemento secundario de otro control, se quita de ese control antes de agregarse a otro control.If the Control is already a child of another control it is removed from that control before it is added to another control.

Notas a los desarrolladores de herederos

Al reemplazar Add(Control) en una clase derivada, asegúrese de llamar al método Add(Control) de la clase base para asegurarse de que el control se agrega a la colección.When overriding Add(Control) in a derived class, be sure to call the base class's Add(Control) method to ensure that the control is added to the collection.

Se aplica a

Consulte también: