ControlCollection Classe

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Fornece um contentor de recolha que permite aos controlos do servidor ASP.NET manter uma lista dos seus controlos filhos.

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 seguinte sobrepõe o Control.CreateChildControls método para criar dois controlos, ambos instâncias da classe personalizada chamada ChildControl, que tem uma propriedade de cadeia chamada Message. Quando criados, os dois controlos são adicionados ao ControlCollection. O Add método é chamado em cada um destes controlos para os adicionar à classe que contém esta versão de Control.CreateChildControls. A ChildControlsCreated propriedade está definida para true que estes controlos 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

Observações

Pode aceder a qualquer uma das propriedades e métodos da ControlCollection classe através da Control.Controls propriedade. Como a classe Control é a classe base para todos os controlos ASP.NET servidor, todos os controlos de servidor herdam esta propriedade.

Para mais informações sobre coleções, consulte Coleções e Estruturas de Dados.

Construtores

Name Description
ControlCollection(Control)

Inicializa uma nova instância da ControlCollection classe para o controlo do servidor pai especificado.

Propriedades

Name Description
Count

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

Recebe um valor que indica se o ControlCollection objeto é apenas de leitura.
IsSynchronized

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

Obtém uma referência ao controlo do servidor na localização de índice especificada no ControlCollection objeto.
Owner

Obtém o controlo do servidor ASP.NET ao qual pertence o objeto ControlCollection.
SyncRoot

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

Métodos

Name Description
Add(Control)

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

Adiciona o objeto especificado Control à coleção na localização do índice especificada.
Clear()

Remove todos os controlos do objeto do ControlCollection controlo do servidor atual.
Contains(Control)

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

Copia os controlos filhos armazenados no ControlCollection objeto para um Array objeto, começando na localização do índice especificada no Array.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEnumerator()

Recupera um enumerador que pode iterar através do ControlCollection objeto.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(Control)

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

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Remove(Control)

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

Remove um controlo filho, na localização do índice especificado, do ControlCollection objeto.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

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

Converte um IEnumerable para um IQueryable.
Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também