Control.Controls Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní.
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 ControlCollectionHodnota vlastnosti
Kolekce podřízených ovládacích prvků pro zadaný serverový ovládací prvek.
- Atributy
Příklady
Následující příklad ukazuje, jak přidat podřízené ovládací prvky do objektu serverového ControlCollection ovládacího prvku prostřednictvím jeho Controls vlastnosti.
Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
Poznámky
Na stránce ASP.NET, když jsou ovládací prvky přidány deklarativní mezi levou a pravou značku 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. Všechny značky HTML nebo textové řetězce, které nejsou zpracovány na serveru, jsou považovány za LiteralControl objekty. Ty se přidají do kolekce, jako jsou jiné ovládací prvky serveru.
Vlastnost Controls umožňuje programový přístup k instanci ControlCollection třídy pro libovolný server řízení. Do kolekce můžete přidávat ovládací prvky, odebírat ovládací prvky z kolekce nebo iterovat ovládacími prvky serveru v kolekci.
Poznámky pro dědice
Při přepsání Controls vlastnosti nezapomeňte metodu EnsureChildControls() volat. 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ů v přepsáné CreateChildControls() metodě.
