Compartir por

ControlCollection Clase

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Proporciona un contenedor de recopilación que permite a ASP.NET controles de servidor mantener una lista de sus controles secundarios.

public ref class ControlCollection : System::Collections::ICollection
public class ControlCollection : System.Collections.ICollection
type ControlCollection = class
    interface ICollection
    interface IEnumerable
Public Class ControlCollection
Implements ICollection
Herencia
Object
ControlCollection
Derivado
Implementaciones
ICollection IEnumerable

Ejemplos

En el ejemplo de código siguiente se invalida el Control.CreateChildControls método para crear dos controles, ambas instancias de la clase personalizada denominada ChildControl, que tiene una propiedad de cadena denominada Message. Cuando se crea, los dos controles se agregan a .ControlCollection Se Add llama al método en cada uno de estos controles para agregarlos a la clase que contiene esta versión de Control.CreateChildControls. La ChildControlsCreated propiedad se establece true en para que estos controles no se vuelvan a crear innecesariamente.


protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}


Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub

Comentarios

Puede acceder a cualquiera de las propiedades y métodos de la ControlCollection clase a través de la Control.Controls propiedad . Puesto que la Control clase es la clase base para todos los controles de servidor ASP.NET, todos los controles de servidor heredan esta propiedad.

Para obtener más información sobre las colecciones, consulte Colecciones y estructuras de datos.

Constructores

Nombre Description
ControlCollection(Control)

Inicializa una nueva instancia de la ControlCollection clase para el control de servidor primario especificado.

Propiedades

Nombre Description
Count

Obtiene el número de controles de servidor del ControlCollection objeto para el control de servidor ASP.NET especificado.
IsReadOnly

Obtiene un valor que indica si el ControlCollection objeto es de solo lectura.
IsSynchronized

Obtiene un valor que indica si el ControlCollection objeto está sincronizado.
Item[Int32]

Obtiene una referencia al control de servidor en la ubicación de índice especificada en el ControlCollection objeto .
Owner

Obtiene el control de servidor ASP.NET al que pertenece el ControlCollection objeto.
SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a la colección de controles.

Métodos

Nombre Description
Add(Control)

Agrega el objeto especificado Control a la colección.
AddAt(Int32, Control)

Agrega el objeto especificado Control a la colección en la ubicación de índice especificada.
Clear()

Quita todos los controles del objeto del control de ControlCollection servidor actual.
Contains(Control)

Determina si el control de servidor especificado está en el objeto del control de ControlCollection servidor primario.
CopyTo(Array, Int32)

Copia los controles secundarios almacenados en el ControlCollection objeto en un Array objeto, empezando por la ubicación de índice especificada en .Array
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetEnumerator()

Recupera un enumerador que puede recorrer en iteración el ControlCollection objeto .
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IndexOf(Control)

Recupera el índice de un objeto especificado Control en la colección.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
Remove(Control)

Quita el control de servidor especificado del objeto del control de ControlCollection servidor primario.
RemoveAt(Int32)

Quita un control secundario, en la ubicación de índice especificada, del ControlCollection objeto .
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Métodos de extensión

Nombre Description
AsParallel(IEnumerable)

Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)

Convierte un IEnumerable en un IQueryable.
Cast<TResult>(IEnumerable)

Convierte los elementos de un IEnumerable al tipo especificado.
OfType<TResult>(IEnumerable)

Filtra los elementos de un IEnumerable en función de un tipo especificado.

Se aplica a

Consulte también