Control.Controls Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

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.ControlCollection

Public Overridable ReadOnly Property Controls As ControlCollection

Hodnota vlastnosti

ControlCollection

Kolekce podřízených ovládacích prvků pro zadaný ovládací prvek serveru.

Atributy: BrowsableAttribute

Příklady

Následující příklad ukazuje, jak přidat podřízené ovládací prvky do objektu ControlCollection ovládacího prvku serveru prostřednictvím jeho Controls vlastnosti.

Controls.Add(new LiteralControl("<h3>Value: "));

Controls.Add(New LiteralControl("<h3>Value: "))

Poznámky

Na ASP.NET stránce se ovládací prvky přidávají deklarativní mezi levou a pravou značkou ovládacího prvku serveru, 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é se na serveru nezpracovávají, se považují za LiteralControl objekty. Tyto prvky 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 jakýkoli 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ě.

Platí pro