Control.ControlCollection.Add(Control) Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega el control especificado a la colección de controles.
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)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.
El objeto asignado al parámetro value no es un Control.
En el ejemplo de código siguiente se agrega a Control de Control.ControlCollection la clase Panelderivada . El ejemplo requiere que haya creado un Panel control y un Button control en .Form Cuando se hace clic en el botón, se agrega un TextBox control al panel.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
El Add método permite agregar Control objetos al final de la colección de controles.
También puede agregar nuevos Control objetos a la colección mediante el AddRange método .
Para quitar un Control objeto que agregó anteriormente, use los Removemétodos , RemoveAto Clear .
Nota
Solo Control se puede asignar un objeto a uno Control.ControlCollection cada vez. Control Si ya es un elemento secundario de otro control, se quita de ese control antes de agregarlo a otro control.
Al invalidar Add(Control) en una clase derivada, asegúrese de llamar al método de Add(Control) la clase base para asegurarse de que el control se agrega a la colección.
| Producto | Versiones |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |