ControlCollection(Control) Конструктор
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализация нового экземпляра класса ControlCollection для заданного родительского серверного элемента управления.
public:
ControlCollection(System::Web::UI::Control ^ owner);
public ControlCollection (System.Web.UI.Control owner);
new System.Web.UI.ControlCollection : System.Web.UI.Control -> System.Web.UI.ControlCollection
Public Sub New (owner As Control)
Параметры
- owner
- Control
ASP.NET серверный элемент управления, для которого создается коллекция элементов управления.
Исключения
Происходит, если параметр owner
равен null
.
Примеры
Следующий пример кода представляет собой пользовательский ControlCollection класс, который переопределяет конструктор для записи сообщений (включая имя Owner свойства) в журнал трассировки при создании экземпляра коллекции. Чтобы этот пример работал, необходимо включить трассировку страницы или приложения.
// Create a custom ControlCollection that writes
// information to the Trace log when an instance
// of the collection is created.
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class CustomControlCollection : ControlCollection
{
private HttpContext context;
public CustomControlCollection(Control owner)
: base(owner)
{
HttpContext.Current.Trace.Write("The control collection is created.");
// Display the Name of the control
// that uses this collection when tracing is enabled.
HttpContext.Current.Trace.Write("The owner is: " + this.Owner.ToString());
}
}
' Create a custom ControlCollection that writes
' information to the Trace log when an instance
' of the collection is created.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomControlCollection
Inherits ControlCollection
Private context As HttpContext
Public Sub New(ByVal owner As Control)
MyBase.New(owner)
HttpContext.Current.Trace.Write("The control collection is created.")
' Display the Name of the control
' that uses this collection when tracing is enabled.
HttpContext.Current.Trace.Write("The owner is: " _
& Me.Owner.ToString())
End Sub
End Class