This documentation is archived and is not being maintained.

WebFormsRootDesigner::AddControlToDocument Method

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:
virtual String^ AddControlToDocument(
	Control^ newControl, 
	Control^ referenceControl, 
	ControlLocation location
) abstract

Parameters

newControl
Type: System.Web.UI::Control

The control to add to the Web Forms page.

referenceControl
Type: System.Web.UI::Control

The control relative to which newControl is added.

location
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.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: