Control.Controls Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.
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 propiedad
Colección de controles secundarios del control de servidor especificado.
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo agregar controles secundarios al objeto de un control de servidor a través de ControlCollection su Controls propiedad .
Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
Comentarios
En una página de ASP.NET, cuando los controles se agregan declarativamente entre las etiquetas de apertura y cierre de un control de servidor, ASP.NET agrega automáticamente los controles al control de servidor contenedor.ControlCollection Las etiquetas HTML o cadenas de texto que no se procesan en el servidor se tratan como LiteralControl objetos. Se agregan a la colección como otros controles de servidor.
La Controls propiedad permite el acceso mediante programación a la instancia de la ControlCollection clase para cualquier control de servidor. Puede agregar controles a la colección, quitar controles de la colección o recorrer en iteración los controles de servidor de la colección.
Notas a los desarrolladores de herederos
Al invalidar la Controls propiedad , asegúrese de llamar al EnsureChildControls() método . Además, si tiene previsto agregar controles a la colección controls mediante programación, considere la posibilidad de agregar los controles en un método invalidado CreateChildControls() .