ControlCollection Classe

Definição

Fornece um contêiner de coleção que permite que controles de servidor ASP.NET mantenham uma lista de seus controles filho.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
Herança
ControlCollection
Derivado
Implementações

Exemplos

O exemplo de código a seguir Control.CreateChildControls substitui o método para criar dois controles, ambas as instâncias da classe ChildControlpersonalizada denominada, que tem uma Messagepropriedade de cadeia de caracteres chamada.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. Quando criados, os dois controles são adicionados ao ControlCollection.When created, the two controls are added to the ControlCollection. O Add método é chamado em cada um desses controles para adicioná-los à classe que contém esta versão do Control.CreateChildControls.The Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. A ChildControlsCreated propriedade é definida como true para que esses controles não sejam criados novamente desnecessariamente.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


Comentários

Você pode acessar qualquer uma das propriedades e métodos da ControlCollection classe por meio da Control.Controls propriedade.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Como a Control classe é a classe base para todos os controles de servidor ASP.net, todos os controles de servidor herdam essa propriedade.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Para obter mais informações sobre coleções, consulte coleções e estruturas de dados.For more information about collections, see Collections and Data Structures.

Construtores

ControlCollection(Control)

Inicializa uma nova instância da classe ControlCollection para o controle de servidor pai especificado.Initializes a new instance of the ControlCollection class for the specified parent server control.

Propriedades

Count

Obtém o número de controles de servidor no objeto ControlCollection para o controle de servidor ASP.NET especificado.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly

Obtém um valor que indica se o objeto ControlCollection é somente leitura.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized

Obtém um valor que indica se o objeto ControlCollection é sincronizado.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32]

Obtém uma referência para o controle de servidor no local do índice especificado no objeto ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner

Obtém o controle de servidor ASP.NET ao qual o objeto ControlCollection pertence.Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção de controels.Gets an object that can be used to synchronize access to the collection of controls.

Métodos

Add(Control)

Adiciona o objeto Control especificado à coleção.Adds the specified Control object to the collection.

AddAt(Int32, Control)

Adiciona o objeto Control especificado à coleção no local de índice especificado.Adds the specified Control object to the collection at the specified index location.

Clear()

Remove todos os controles do objeto ControlCollection do controle dde servidor atual.Removes all controls from the current server control's ControlCollection object.

Contains(Control)

Determina se o controle de servidor especificado está no objeto ControlCollection do controle de servidor pai.Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32)

Copia os controles filho armazenados no objeto ControlCollection para um objeto Array, começando no local do índice especificado no 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)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEnumerator()

Recupera um enumerador que pode iterar por meio do objeto ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(Control)

Recupera o índice de um objeto Control especificado na coleção.Retrieves the index of a specified Control object in the collection.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Remove(Control)

Remove o servidor especificado do objeto ControlCollection do controle de servidor pai.Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32)

Remove um controle filho, no local do índice especificado, do objeto ControlCollection.Removes a child control, at the specified index location, from the ControlCollection object.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também