FileLevelPageControlBuilder.AppendSubBuilder(ControlBuilder) Method

Definition

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

C#
public override void AppendSubBuilder(System.Web.UI.ControlBuilder subBuilder);

Parameters

subBuilder
ControlBuilder

The ControlBuilder assigned to the child control.

Exceptions

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.

Remarks

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.

Applies to

Proizvod Verzije
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also