Compartilhar via


ControlParser.ParseControl Método

Definição

Cria um controle com base na marcação especificada.

Sobrecargas

Nome Description
ParseControl(IDesignerHost, String)

Cria um controle da marcação especificada usando o host de designer especificado.

ParseControl(IDesignerHost, String, String)

Cria um controle da marcação especificada usando o host e as diretivas do designer especificados.

ParseControl(IDesignerHost, String)

Cria um controle da marcação especificada usando o host de 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 host do designer para a página.

controlText
String

A marcação HTML para o controle.

Retornos

O ControlcontrolText representa; caso contrário, nullse o analisador não puder criar o controle.

Exceções

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

Exemplos

O exemplo de código a seguir mostra como criar um controle com base no 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())

Comentários

O ParseControl método acessa a cadeia de caracteres que representa as diretivas de registro na página da Web ASP.NET usando os serviços do host do designer. Os serviços de host do designer são adquiridos por meio ReferenceManager da propriedade do RootDesigner objeto ou, se isso não estiver disponível, o IWebFormReferenceManager serviço.

O ParseControl método gerará uma exceção se o analisador não puder criar o controle.

Confira também

Aplica-se a

ParseControl(IDesignerHost, String, String)

Cria um controle da marcação especificada usando o host e as diretivas do designer especificados.

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

Parâmetros

designerHost
IDesignerHost

Uma IDesignerHost instância que é o host do designer para a página.

controlText
String

O texto da marcação HTML para o controle.

directives
String

As diretivas de página a serem incluídas no código do controle.

Retornos

O Control que controlText representa.

Exceções

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

Exemplos

O exemplo de código a seguir mostra como criar um controle com base no 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())

Comentários

O ParseControl método acessa a cadeia de caracteres que representa as diretivas de registro na página da Web ASP.NET usando os serviços do host do designer. Os serviços de host do designer são adquiridos por meio ReferenceManager da propriedade do RootDesigner objeto ou, se isso não estiver disponível, o IWebFormReferenceManager serviço.

O ParseControl método gerará uma exceção se o analisador não puder criar o controle.

Confira também

Aplica-se a