Sdílet prostřednictvím


Control.Controls Vlastnost

Definice

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

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

Viz také