This documentation is archived and is not being maintained.

ControlCollection.ControlCollection Constructor

Initializes a new instance of the ControlCollection class for the specified parent server control.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

public ControlCollection (
	Control owner
)
public ControlCollection (
	Control owner
)
public function ControlCollection (
	owner : Control
)
Not applicable.

Parameters

owner

The ASP.NET server control that the control collection is created for.

Exception typeCondition

ArgumentNullException

Occurs if the owner parameter is a null reference (Nothing in Visual Basic).

The following code example is a custom ControlCollection class that overrides the constructor to write messages (which include the name of the Owner property) to the trace log when an instance of the collection is created. You must enable tracing for the page or application for this example to work.

// 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());
    }
}

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Show: