Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original
Este tema aún no ha recibido ninguna valoración - Valorar este tema

Control.ControlCollection.Add (Método)

.NET Framework 4

Agrega el control especificado a la colección de controles.

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)
C#
C++
F#
VB
Copiar 
public virtual void Add(
	Control value
)

Parámetros

value
Tipo: System.Windows.Forms.Control
Control que se va a agregar a la colección.
Excepción Condición
Exception

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.

ArgumentException

El objeto asignado al parámetro value no es un Control.

El método Add permite agregar objetos Control al final de la colección de controles.

También se pueden agregar nuevos objetos Control a la colección utilizando el método AddRange.

Para quitar un objeto Control anteriormente agregado, utilice los métodos Remove, RemoveAt o Clear.

Nota Nota

Un objeto Control sólo se puede asignar a una colección Control.ControlCollection a la vez. Si el Control ya es secundario de otro control, se quita de ese control antes de agregarlo a otro.

Notas para los herederos

Al reemplazar el método Add en una clase derivada, asegúrese de llamar al método Add de la clase base para agregar el control a la colección.

En el siguiente ejemplo se agrega un objeto Control a la colección Control.ControlCollection de la clase derivada Panel. El ejemplo requiere que se haya creado con anterioridad un control Panel y Button en un objeto Form. Al hacer clic en el botón, se agrega un control TextBox a la colección Control.ControlCollection del panel.

C#
C++
VB
Copiar 

// 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);
}

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes