Compartir vía


Control.Controls Propiedad

Definición

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.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Valor de propiedad

ControlCollection

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() .

Se aplica a

Consulte también