Control.Controls Właściwość

Definicja

Pobiera obiekt ControlCollection, który reprezentuje kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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; }
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Wartość właściwości

Kolekcja formantów podrzędnych dla określonej kontrolki serwerowej.The collection of child controls for the specified server control.

Atrybuty

Przykłady

W poniższym przykładzie pokazano, jak dodać kontrolki podrzędne do obiektu ControlCollection formantu serwera za pomocą właściwości Controls.The following example demonstrates how to add child controls to a server control's ControlCollection object through its Controls property.

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

Uwagi

Na stronie ASP.NET, gdy kontrolki są dodawane deklaratywnie między tagiem otwierającym i zamykającym kontrolki serwera, ASP.NET automatycznie dodaje formanty do ControlCollectionzawierającej kontrolki serwerowej.On an ASP.NET page, when controls are added declaratively between the opening and closing tags of a server control, ASP.NET automatically adds the controls to the containing server control's ControlCollection. Wszystkie Tagi HTML lub ciągi tekstowe, które nie są przetwarzane na serwerze, są traktowane jako obiekty LiteralControl.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Są one dodawane do kolekcji, podobnie jak inne kontrolki serwera.These are added to the collection like other server controls.

Właściwość Controls umożliwia programistyczny dostęp do wystąpienia klasy ControlCollection dla dowolnej kontrolki serwerowej.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. Można dodać kontrolki do kolekcji, usunąć kontrolki z kolekcji lub wykonać iterację w formantach serwera w kolekcji.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Uwagi dotyczące dziedziczenia

Podczas zastępowania właściwości Controls należy wywołać metodę EnsureChildControls().When overriding the Controls property, be sure to call the EnsureChildControls() method. Ponadto, jeśli planujesz dodać kontrolki do kolekcji formantów programowo, rozważ dodanie kontrolek w zastąpionej metodzie CreateChildControls().Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

Dotyczy

Zobacz też