ControlParser.ParseControl Method (IDesignerHost, String, String)

Creates a control from the specified persisted control code using the specified designer host and directives.

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

public:
static Control^ ParseControl (
	IDesignerHost^ designerHost, 
	String^ controlText, 
	String^ directives
)
public static Control ParseControl (
	IDesignerHost designerHost, 
	String controlText, 
	String directives
)
public static function ParseControl (
	designerHost : IDesignerHost, 
	controlText : String, 
	directives : String
) : Control

Parameters

designerHost

An IDesignerHost that is the designer host for the page.

controlText

The text of the HTML markup for the control.

directives

The page directives to include in the code for the control.

Return Value

The Control that controlText represents.

Exception typeCondition

ArgumentNullException

A parameter is not valid.

The ParseControl method accesses the string representing the register directives on the Web Forms page using the services of the designer host. Designer host services are acquired through the ReferenceManager property of the RootDesigner object, or if that is not available, the IWebFormReferenceManager service.

The ParseControl method throws an exception, if the parser cannot build the control.

The following code example shows how to create a control from HTML markup text.

This code example is part of a larger example provided for the ControlParser class.

// Create a Web control from the persisted control String*.
System::Web::UI::Control^ ctrl = ControlParser::ParseControl( host, inputForm->tbox->Text->Trim() );

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0
Show: