Control.Controls Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface.
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 de Propriedade
A coleção de controlos filhos para o controlo do servidor especificado.
- Atributos
Exemplos
O exemplo seguinte demonstra como adicionar controlos filhos ao objeto de ControlCollection um controlo de servidor através da sua Controls propriedade.
Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
Observações
Numa página ASP.NET, quando os controlos são adicionados declarativamente entre as etiquetas de abertura e fecho de um controlo de servidor, ASP.NET adiciona automaticamente os controlos ao ControlCollection do controlo do servidor que o contém. Quaisquer etiquetas HTML ou cadeias de texto que não sejam processadas no servidor são tratadas como LiteralControl objetos. Estes são adicionados à coleção como outros controlos de servidor.
A Controls propriedade permite-lhe acesso programático à instância da ControlCollection classe para qualquer controlo de servidor. Podes adicionar controlos à coleção, remover controlos da coleção, ou iterar através dos controlos do servidor dentro da coleção.
Notas para Herdeiros
Ao anular a propriedade Controls , certifique-se de contactar o EnsureChildControls() sistema. Além disso, se planeia adicionar controlos à coleção de controlos de forma programática, considere adicionar os controlos num método sobreposto CreateChildControls() .