This documentation is archived and is not being maintained.

FileLevelPageControlBuilder.AppendSubBuilder Method

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.


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

Supported in: 4, 3.5, 3.0, 2.0

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.