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() метод.
