ControlParser.ParseControl Método

Definição

Espaço de Nomes:: System.Web.UI.Design

Assemblagem:: System.Design.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria um controlo a partir da marcação especificada.

Sobrecargas

Name	Description
ParseControl(IDesignerHost, String)	Cria um controlo a partir da marcação especificada usando o host designer especificado.
ParseControl(IDesignerHost, String, String)	Cria um controlo a partir da marcação especificada usando o host designer e as diretivas especificadas.

ParseControl(IDesignerHost, String)

Cria um controlo a partir da marcação especificada usando o host designer especificado.

public:
 static System::Web::UI::Control ^ ParseControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText);

public static System.Web.UI.Control ParseControl(System.ComponentModel.Design.IDesignerHost designerHost, string controlText);

static member ParseControl : System.ComponentModel.Design.IDesignerHost * string -> System.Web.UI.Control

Public Shared Function ParseControl (designerHost As IDesignerHost, controlText As String) As Control

Parâmetros

designerHost: IDesignerHost

Uma IDesignerHost instância que é o anfitrião designer da página.

controlText: String

A marcação HTML para o controlo.

Devoluções

Control

O ControlcontrolText representa; caso contrário, null, se o parser não conseguir construir o controlo.

Exceções

ArgumentNullException

Um parâmetro não é válido.

Exemplos

O exemplo de código seguinte mostra como criar um controlo a partir de texto de marcação HTML. Este exemplo de código faz parte de um exemplo maior fornecido para a ControlParser classe.

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

// Create a Web control from the HTML markup.
System.Web.UI.Control ctrl =
    ControlParser.ParseControl(host, inputForm.TBox.Text.Trim());

' Create a Web control from the persisted control string.
Dim ctrl As System.Web.UI.Control = ControlParser.ParseControl(host, inputForm.TxBox.Text.Trim())

Observações

O método ParseControl acede à cadeia que representa as diretivas de registo na página web ASP.NET usando os serviços do host designer. Os serviços de hospedeiro designer são adquiridos através da ReferenceManager propriedade do RootDesigner objeto, ou, se esta não estiver disponível, do IWebFormReferenceManager serviço.

O ParseControl método lança uma exceção se o analisador não conseguir construir o controlo.

Ver também

Aplica-se a

ParseControl(IDesignerHost, String, String)

Cria um controlo a partir da marcação especificada usando o host designer e as diretivas especificadas.

public:
 static System::Web::UI::Control ^ ParseControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::String ^ controlText, System::String ^ directives);

public static System.Web.UI.Control ParseControl(System.ComponentModel.Design.IDesignerHost designerHost, string controlText, string directives);

static member ParseControl : System.ComponentModel.Design.IDesignerHost * string * string -> System.Web.UI.Control

Public Shared Function ParseControl (designerHost As IDesignerHost, controlText As String, directives As String) As Control