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.ControlCollectionPublic Overridable ReadOnly Property Controls As 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() метод.