ControlCollection Clase

Definición

Proporciona un contenedor de colecciones que permite a los controles de servidor ASP.NET mantener una lista de los 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
ControlCollection
Derivado
Implementaciones

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, vea Colecciones y estructuras de datos.

Constructores

ControlCollection(Control)

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

Propiedades

Count

Obtiene el número de controles de servidor que hay en el objeto ControlCollection para el control de servidor ASP.NET especificado.

IsReadOnly

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

IsSynchronized

Obtiene un valor que indica si el objeto ControlCollection está sincronizado.

Item[Int32]

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

Owner

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

SyncRoot

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

Métodos

Add(Control)

Agrega a la colección el objeto Control especificado.

AddAt(Int32, Control)

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

Clear()

Quita todos los controles del objeto ControlCollection del control de servidor actual.

Contains(Control)

Determina si el control de servidor especificado está en el objeto ControlCollection del control de servidor principal.

CopyTo(Array, Int32)

Copia los controles secundarios almacenados en el objeto ControlCollection en un objeto Array, comenzando por la ubicación de índice especificada en Array.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetEnumerator()

Recupera un enumerador que puede iterar por el objeto ControlCollection.

GetHashCode()

Sirve como la 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 Control especificado en la colección.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Remove(Control)

Quita el control de servidor especificado del objeto ControlCollection del control de servidor principal.

RemoveAt(Int32)

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

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.

OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Consulte también