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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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; }
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Valor de propiedad

Colección de controles secundarios del control de servidor especificado.The collection of child controls for the specified server control.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo agregar controles secundarios al objeto ControlCollection de un control de servidor a través de su propiedad Controls.The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.

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 mediante declaración entre las etiquetas de apertura y cierre de un control de servidor, ASP.NET agrega automáticamente los controles al ControlCollectiondel control de servidor contenedor.On an ASP.NET page, when controls are added declaratively between the opening and closing tags of a server control, ASP.NET automatically adds the controls to the containing server control's ControlCollection. Cualquier etiqueta HTML o cadena de texto que no se haya procesado en el servidor se trata como LiteralControl objetos.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Estos se agregan a la colección como otros controles de servidor.These are added to the collection like other server controls.

La propiedad Controls permite el acceso mediante programación a la instancia de la clase ControlCollection para cualquier control de servidor.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. 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.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Notas a los desarrolladores de herederos

Al reemplazar la propiedad Controls, asegúrese de llamar al método EnsureChildControls().When overriding the Controls property, be sure to call the EnsureChildControls() method. Además, si piensa agregar controles a la colección de controles mediante programación, considere la posibilidad de agregar los controles en un método CreateChildControls() invalidado.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

Se aplica a

Consulte también: