ControlCollection Classe

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Fornece um contêiner de coleção que permite que controles de servidor ASP.NET mantenham uma lista de seus controles filho.

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
Herança
Object
ControlCollection
Derivado
Implementações
ICollection IEnumerable

Exemplos

O exemplo de código a seguir substitui o Control.CreateChildControls método para criar dois controles, ambas as instâncias da classe personalizada chamada ChildControl, que tem uma propriedade de cadeia de caracteres chamada Message. Quando criados, os dois controles são adicionados ao ControlCollection. O Add método é chamado em cada um desses controles para adicioná-los à classe que contém essa versão do Control.CreateChildControls. A ChildControlsCreated propriedade é definida como para true que esses controles não sejam criados novamente desnecessariamente.


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

Comentários

Você pode acessar qualquer uma das propriedades e métodos da ControlCollection classe por meio da Control.Controls propriedade . Como a Control classe é a classe base para todos os controles de servidor ASP.NET, todos os controles de servidor herdam essa propriedade.

Para obter mais informações sobre coleções, consulte Coleções e estruturas de dados.

Construtores

ControlCollection(Control)

Inicializa uma nova instância da classe ControlCollection para o controle de servidor pai especificado.

Propriedades

Count

Obtém o número de controles de servidor no objeto ControlCollection para o controle de servidor ASP.NET especificado.
IsReadOnly

Obtém um valor que indica se o objeto ControlCollection é somente leitura.
IsSynchronized

Obtém um valor que indica se o objeto ControlCollection está sincronizado.
Item[Int32]

Obtém uma referência para o controle de servidor no local do índice especificado no objeto ControlCollection.
Owner

Obtém o controle de servidor ASP.NET ao qual o objeto ControlCollection pertence.
SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controels.

Métodos

Add(Control)

Adiciona o objeto Control especificado à coleção.
AddAt(Int32, Control)

Adiciona o objeto Control especificado à coleção no local de índice especificado.
Clear()

Remove todos os controles do objeto ControlCollection do controle dde servidor atual.
Contains(Control)

Determina se o controle de servidor especificado está no objeto ControlCollection do controle de servidor pai.
CopyTo(Array, Int32)

Copia os controles filho armazenados no objeto ControlCollection para um objeto Array, começando no local do índice especificado no Array.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEnumerator()

Recupera um enumerador que pode iterar pelo objeto ControlCollection.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Control)

Recupera o índice de um objeto Control especificado na coleção.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Remove(Control)

Remove o servidor especificado do objeto ControlCollection do controle de servidor pai.
RemoveAt(Int32)

Remove um controle filho, no local do índice especificado, do objeto ControlCollection.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.

Aplica-se a

Confira também