Control.Controls Vlastnost

Definice

Získává ControlCollection objekt, který představuje podřízené ovládací prvky pro zadaný serverový ovládací prvek v hierarchii uživatelského rozhraní.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; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Hodnota vlastnosti

ControlCollection

Kolekce podřízených ovládacích prvků pro určený serverový ovládací prvek.The collection of child controls for the specified server control.

Atributy

Příklady

Následující příklad ukazuje, jak přidat podřízené ovládací prvky do objektu serverového ovládacího prvku ControlCollection prostřednictvím jeho Controls Vlastnosti.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: "))
  

Poznámky

Pokud se na stránce ASP.NET přidávají ovládací prvky deklarativně mezi otevírací a uzavírací značkou serverového ovládacího prvku, ASP.NET automaticky přidá ovládací prvky do obsahujícího serverového ovládacího prvku ControlCollection .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. Všechny značky HTML nebo textové řetězce, které nejsou zpracovány na serveru, jsou považovány za LiteralControl objekty.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Ty se přidají do kolekce jako jiné serverové ovládací prvky.These are added to the collection like other server controls.

ControlsVlastnost umožňuje programový přístup k instanci ControlCollection třídy pro libovolný serverový ovládací prvek.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. Do kolekce můžete přidat ovládací prvky, odebrat ovládací prvky z kolekce nebo iterovat přes ovládací prvky serveru v kolekci.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Poznámky pro dědice

Při přepisování Controls vlastnosti nezapomeňte zavolat EnsureChildControls() metodu.When overriding the Controls property, be sure to call the EnsureChildControls() method. Kromě toho, pokud plánujete přidat ovládací prvky do kolekce ovládacích prvků programově, zvažte přidání ovládacích prvků do přepsané CreateChildControls() metody.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

Platí pro

Viz také