FileLevelPageControlBuilder.AppendSubBuilder Method (ControlBuilder)


Adds a ControlBuilder object to the FileLevelPageControlBuilder object for any child controls that belong to the container control.

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

public override void AppendSubBuilder(
	ControlBuilder subBuilder


Type: System.Web.UI.ControlBuilder

The ControlBuilder assigned to the child control.

Exception Condition

The ControlBuilder that was added is associated with a Content control and is only allowed on pages that contain Content controls.


The content page contained a literal other than a Content control.

The AppendSubBuilder method overrides the ControlBuilder.AppendSubBuilder method to provide custom logic when master pages and content pages are being used. In a content page, anything that is not inside the Content control (except script blocks for server code) raises an HttpParseException exception. Adding a ControlBuilder object for a child control that is a Content control raises an HttpException exception. For more information about master and content pages, see ASP.NET Master Pages.

.NET Framework
Available since 2.0
Return to top