ControlCollection ControlCollection ControlCollection ControlCollection Class

Definición

Proporciona un contenedor de colecciones que permite a los controles de servidor ASP.NET mantener una lista de los controles secundarios.Provides a collection container that enables ASP.NET server controls to maintain a list of their child controls.

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
ControlCollectionControlCollectionControlCollectionControlCollection
Derivado
Implementaciones

Ejemplos

En el ejemplo de código siguiente se invalida Control.CreateChildControls el método para crear dos controles, ambas instancias de la clase personalizada ChildControldenominada, que tiene una propiedad de Messagecadena denominada.The following code example overrides the Control.CreateChildControls method to create two controls, both instances of the custom class named ChildControl, which has a string property named Message. Cuando se crean, los dos controles se agregan ControlCollectiona.When created, the two controls are added to the ControlCollection. Se Add llama al método en cada uno de estos controles para agregarlos a la clase que contiene esta versión Control.CreateChildControlsde.The Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. La ChildControlsCreated propiedad se establece en true para que estos controles no se creen de nuevo innecesariamente.The ChildControlsCreated property is set to true so that these controls will not be created again unnecessarily.


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 tener acceso a cualquiera de las propiedades y métodos de ControlCollection la clase a Control.Controls través de la propiedad.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Dado que Control la clase es la clase base para todos los controles de servidor de ASP.net, todos los controles de servidor heredan esta propiedad.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Para obtener más información sobre las colecciones, vea colecciones y estructuras de datos.For more information about collections, see Collections and Data Structures.

Constructores

ControlCollection(Control) ControlCollection(Control) ControlCollection(Control) ControlCollection(Control)

Inicializa una instancia nueva de la clase ControlCollection para el control de servidor principal especificado.Initializes a new instance of the ControlCollection class for the specified parent server control.

Propiedades

Count Count Count Count

Obtiene el número de controles de servidor que hay en el objeto ControlCollection para el control de servidor ASP.NET especificado.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtiene un valor que indica si el objeto ControlCollection es de solo lectura.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtiene un valor que indica si el objeto ControlCollection está sincronizado.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Obtiene una referencia al control de servidor en la ubicación de índice especificada en el objeto ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner Owner Owner Owner

Obtiene el control de servidor ASP.NET al que pertenece el objeto ControlCollection.Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot SyncRoot SyncRoot SyncRoot

Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles.Gets an object that can be used to synchronize access to the collection of controls.

Métodos

Add(Control) Add(Control) Add(Control) Add(Control)

Agrega a la colección el objeto Control especificado.Adds the specified Control object to the collection.

AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control)

Agrega el objeto Control especificado a la colección en la ubicación de índice especificada.Adds the specified Control object to the collection at the specified index location.

Clear() Clear() Clear() Clear()

Quita todos los controles del objeto ControlCollection del control de servidor actual.Removes all controls from the current server control's ControlCollection object.

Contains(Control) Contains(Control) Contains(Control) Contains(Control)

Determina si el control de servidor especificado está en el objeto ControlCollection del control de servidor principal.Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) 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.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Recupera un enumerador que puede recorrer en iteración el objeto ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

Recupera el índice de un objeto Control especificado en la colección.Retrieves the index of a specified Control object in the collection.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) Remove(Control)

Quita el control de servidor especificado del objeto ControlCollection del control de servidor principal.Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Quita un control secundario, situado en la ubicación de índice especificada, del objeto ControlCollection.Removes a child control, at the specified index location, from the ControlCollection object.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Métodos de extensión

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: