Control.Controls Свойство

Определение

Возвращает объект ControlCollection, который представляет дочерние элементы управления для указанного элемента управления сервера в иерархии пользовательского интерфейса.

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

Коллекция дочерних элементов для указанного элемента управления сервера.

Атрибуты

Примеры

В следующем примере показано, как добавить дочерние элементы управления в объект серверного элемента управления с ControlCollection помощью его Controls Свойства.

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

Комментарии

На странице ASP.NET при декларативном добавлении элементов управления между открывающим и закрывающим тегами серверного элемента управления ASP.NET автоматически добавляет элементы управления в содержащий серверный элемент управления ControlCollection . Любые HTML-теги или текстовые строки, которые не обрабатываются на сервере, обрабатываются как LiteralControl объекты. Они добавляются в коллекцию, как и другие серверные элементы управления.

ControlsСвойство обеспечивает программный доступ к экземпляру ControlCollection класса для любого серверного элемента управления. Можно добавлять элементы управления в коллекцию, удалять элементы управления из коллекции или выполнять перебор элементов управления сервера в коллекции.

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

При переопределении Controls свойства обязательно вызовите EnsureChildControls() метод. Кроме того, если планируется программное добавление элементов управления в коллекцию элементов управления, рекомендуется добавить элементы управления в переопределенный CreateChildControls() метод.

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

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