WebFormsRootDesigner.AddControlToDocument Method (Control, Control, ControlLocation)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

When overridden in a derived class, adds a Web server control to the Web Forms page.

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

public abstract string AddControlToDocument(
	Control newControl,
	Control referenceControl,
	ControlLocation location


Type: System.Web.UI.Control

The control to add to the Web Forms page.

Type: System.Web.UI.Control

The control relative to which newControl is added.

Type: System.Web.UI.Design.ControlLocation

A ControlLocation value that indicates the location for newControl relative to referenceControl.

Return Value

Type: System.String

The ID of the control that was added.

Although a control might already have an ID assigned to it, if there is already a control in the Web Forms page with the same ID, a new ID is assigned.

.NET Framework
Available since 2.0
Return to top