Udostępnij za pośrednictwem


Control.Controls Właściwość

Definicja

ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.

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

Wartość właściwości

ControlCollection

Kolekcja kontrolek podrzędnych dla określonej kontrolki serwera.

Atrybuty

Przykłady

W poniższym przykładzie pokazano, jak dodać kontrolki podrzędne do obiektu kontrolki ControlCollection serwera za pomocą jego Controls właściwości.

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

Uwagi

Na stronie ASP.NET, gdy kontrolki są dodawane deklaratywnie między tagami otwierania i zamykania kontrolki serwera, ASP.NET automatycznie dodaje kontrolki do kontrolki zawierającej ControlCollectionserwer . Wszystkie tagi HTML lub ciągi tekstowe, które nie są przetwarzane na serwerze, są traktowane jako LiteralControl obiekty. Są one dodawane do kolekcji, podobnie jak inne kontrolki serwera.

Właściwość Controls umożliwia programowy dostęp do wystąpienia ControlCollection klasy dla dowolnej kontroli serwera. Kontrolki można dodawać do kolekcji, usuwać kontrolki z kolekcji lub iterować za pomocą kontrolek serwera w kolekcji.

Uwagi dotyczące dziedziczenia

Podczas zastępowania Controls właściwości pamiętaj, aby wywołać metodę EnsureChildControls() . Ponadto jeśli planujesz programowe dodawanie kontrolek do kolekcji kontrolek, rozważ dodanie kontrolek w metodzie zastępowanej CreateChildControls() .

Dotyczy

Zobacz też