Control.Controls Свойство

Определение

Возвращает объект ControlCollection, который представляет дочерние элементы управления для указанного элемента управления сервера в иерархии пользовательского интерфейса.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; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection

Значение свойства

ControlCollection

Коллекция дочерних элементов для указанного элемента управления сервера.The collection of child controls for the specified server control.

Атрибуты

Примеры

В следующем примере показано, как добавить дочерние элементы управления в объект серверного элемента управления с ControlCollection помощью его 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: "))
  

Комментарии

На странице ASP.NET при декларативном добавлении элементов управления между открывающим и закрывающим тегами серверного элемента управления ASP.NET автоматически добавляет элементы управления в содержащий серверный элемент управления ControlCollection .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. Любые HTML-теги или текстовые строки, которые не обрабатываются на сервере, обрабатываются как LiteralControl объекты.Any HTML tags or text strings that are not processed on the server are treated as LiteralControl objects. Они добавляются в коллекцию, как и другие серверные элементы управления.These are added to the collection like other server controls.

ControlsСвойство обеспечивает программный доступ к экземпляру ControlCollection класса для любого серверного элемента управления.The Controls property allows you programmatic access to the instance of the ControlCollection class for any server control. Можно добавлять элементы управления в коллекцию, удалять элементы управления из коллекции или выполнять перебор элементов управления сервера в коллекции.You can add controls to the collection, remove controls from the collection, or iterate through the server controls in the collection.

Примечания для тех, кто наследует этот метод

При переопределении Controls свойства обязательно вызовите EnsureChildControls() метод.When overriding the Controls property, be sure to call the EnsureChildControls() method. Кроме того, если планируется программное добавление элементов управления в коллекцию элементов управления, рекомендуется добавить элементы управления в переопределенный CreateChildControls() метод.Furthermore, if you are planning to add controls to the controls collection programmatically, consider adding the controls in an overridden CreateChildControls() method.

Применяется к

См. также раздел