Partilhar via


Control.Controls Propriedade

Definição

Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário.

public:
 virtual property System::Web::UI::ControlCollection ^ Controls { System::Web::UI::ControlCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ControlCollection Controls { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Valor da propriedade

ControlCollection

A coleção de controles filho para o controle de servidor especificado.

Atributos

Exemplos

O exemplo a seguir demonstra como adicionar controles filho ao objeto de um controle de servidor por meio de ControlCollection sua Controls propriedade.

Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
  

Comentários

Em uma página ASP.NET, quando os controles são adicionados declarativamente entre as marcas de abertura e fechamento de um controle de servidor, ASP.NET adiciona automaticamente os controles ao controle do ControlCollectionservidor que contém. Todas as marcas HTML ou cadeias de caracteres de texto que não são processadas no servidor são tratadas como LiteralControl objetos. Eles são adicionados à coleção, como outros controles de servidor.

A Controls propriedade permite acesso programático à instância da ControlCollection classe para qualquer controle de servidor. Você pode adicionar controles à coleção, remover controles da coleção ou iterar por meio dos controles do servidor na coleção.

Notas aos Herdeiros

Ao substituir a Controls propriedade, certifique-se de chamar o EnsureChildControls() método. Além disso, se você estiver planejando adicionar controles à coleção de controles programaticamente, considere adicionar os controles em um método substituído CreateChildControls() .

Aplica-se a

Confira também