Control.Controls Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.ControlCollectionPublic Overridable ReadOnly Property Controls As ControlCollectionValor da propriedade
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() .