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