Compartilhar via


ControlParser.ParseControl Método

Definição

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

Sobrecargas

ParseControl(IDesignerHost, String)

Cria um controle com base na marcação especificada usando o host de designer especificado.

ParseControl(IDesignerHost, String, String)

Cria um controle com base na marcação especificada usando as diretivas e o host de designer especificados.

ParseControl(IDesignerHost, String)

Cria um controle com base na 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 instância IDesignerHost que é o host do designer da página.

controlText
String

A marcação HTML para o controle.

Retornos

O Control representado por controlText; caso contrário, null se 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 do 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 da ReferenceManager 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 com base na marcação especificada usando as diretivas e o host de 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 instância IDesignerHost que é o host do designer da 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 para o controle.

Retornos

O Control representado pelo controlText.

Exceções

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

Exemplos

O exemplo de código a seguir mostra como criar um controle do 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 da ReferenceManager 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