FileLevelPageControlBuilder.AppendSubBuilder Method (ControlBuilder)
Adds a ControlBuilder object to the FileLevelPageControlBuilder object for any child controls that belong to the container control.
Assembly: System.Web (in System.Web.dll)
Parameters
- subBuilder
-
Type:
System.Web.UI.ControlBuilder
The ControlBuilder assigned to the child control.
| Exception | Condition |
|---|---|
| HttpException | The ControlBuilder that was added is associated with a Content control and is only allowed on pages that contain Content controls. |
| HttpParseException | 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.
Available since 2.0