Control.Controls Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: BrowsableAttribute

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