ControlCollection Constructor (System.Web.UI)

Switch View :
ScriptFree
.NET Framework Class Library
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)
Syntax

Visual Basic
Public Sub New ( _
	owner As Control _
)
C#
public ControlCollection(
	Control owner
)
Visual C++
public:
ControlCollection(
	Control^ owner
)
F#
new : 
        owner:Control -> ControlCollection

Parameters

owner
Type: System.Web.UI.Control
The ASP.NET server control that the control collection is created for.
Exceptions

Exception Condition
ArgumentNullException

Occurs if the owner parameter is null.

Examples

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.

Visual Basic

    ' 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



C#

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


Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference