Export (0) Print
Expand All

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
)

Parameters

owner
Type: System.Web.UI.Control

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

ExceptionCondition
ArgumentNullException

Occurs if the owner parameter is null.

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

.NET Framework

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

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft