ControlCollection Classe

Definição

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

System.Web.UI.EmptyControlCollection

System.Web.UI.HtmlControls.HtmlTable.HtmlTableRowControlCollection

System.Web.UI.HtmlControls.HtmlTableRow.HtmlTableCellControlCollection

System.Web.UI.WebControls.Table.RowControlCollection

System.Web.UI.WebControls.TableRow.CellControlCollection

Mais…

Implementações

ICollection IEnumerable

Exemplos

O exemplo de código a seguir substitui o Control.CreateChildControls método para criar dois controles, ambas 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 de Control.CreateChildControls. A ChildControlsCreated propriedade é definida 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.

Confira também

• Control
• Page
• Controls
• Coleções e estruturas de dados