Бөлісу құралы:


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

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

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