Provides designer functionality for controls that contain child controls or properties that can be modified at design time.
See Also: ContainerControlDesigner Members
Syntax
Remarks
The System.Web.UI.Design.ContainerControlDesigner class provides a base designer class for controls that can be modified on the design surface. This includes controls that contain child controls or editable inner properties. The System.Web.UI.Design.ContainerControlDesigner provides a single framed region to represent the control, and automatically handles rendering the control at design time.
Apply the System.Web.UI.ParseChildrenAttribute attribute on the associated control to determine the design-time behavior of the System.Web.UI.Design.ContainerControlDesigner. Apply the System.Web.UI.ParseChildrenAttribute settings on the associated control as follows:
false to indicate that the System.Web.UI.Design.ContainerControlDesigner represents the contents of the editable design region as child controls.
true to indicate that the System.Web.UI.Design.ContainerControlDesigner represents the contents of the editable design region as editable inner properties of the control.
Control developers can derive and extend a custom designer from one of several base designers depending on the kind of control that is being developed, as defined in the following list:
Controls that allow child controls to be added to it at design time can derive from the System.Web.UI.Design.ContainerControlDesigner class. For example, the System.Web.UI.Design.WebControls.PanelContainerDesigner class is derived from the System.Web.UI.Design.ContainerControlDesigner class and represents a System.Web.UI.WebControls.Panel control on the design surface.
Controls that have one or more child controls, and might also have an editable designer region where controls can be added at design time, can derive from the System.Web.UI.Design.WebControls.CompositeControlDesigner class.
Controls that require custom design-time processing can derive from the base System.Web.UI.Design.ControlDesigner class.
The System.Web.UI.Design.ContainerControlDesigner class replaces the obsolete System.Web.UI.Design.ReadWriteControlDesigner class.
Use the System.ComponentModel.DesignerAttribute attribute to associate a custom designer class together with a custom control implementation. For detailed information about how to use control designers with custom controls, see Walkthrough: Creating a Basic Control Designer for a Web Server Control.
Requirements
Assembly: System.Design (in System.Design.dll)
Assembly Versions: 2.0.0.0