ControlCollection(Control) Конструктор

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Инициализирует новый экземпляр класса для указанного родительского 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, для который создается коллекция элементов управления.

Исключения

ArgumentNullException

Происходит, если 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

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

• Controls
• Control