TemplateControl.ParseControl Método

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Analisa uma cadeia de caracteres de entrada em um Control objeto na página da Web ASP.NET ou no controle do usuário.

Sobrecargas

Nome Description
ParseControl(String)

Analisa uma cadeia de caracteres de entrada em um Control objeto na página do Web Forms ou no controle de usuário.
ParseControl(String, Boolean)

Analisa uma cadeia de caracteres de entrada em um Control objeto na página da Web ASP.NET ou no controle do usuário.

Comentários

ParseControl é introduzido no .NET Framework versão 3.5. Para obter mais informações, consulte Versões e dependências.

ParseControl(String)

Analisa uma cadeia de caracteres de entrada em um Control objeto na página do Web Forms ou no controle de usuário.

public:
 System::Web::UI::Control ^ ParseControl(System::String ^ content);
public System.Web.UI.Control ParseControl(string content);
member this.ParseControl : string -> System.Web.UI.Control
Public Function ParseControl (content As String) As Control

Parâmetros

content
String

Uma cadeia de caracteres que contém um controle de usuário.

Retornos

Control

O analisado Control.

Exemplos

O exemplo de código a seguir demonstra como criar um Button controle de servidor Web usando o ParseControl método e adiciona o resultado à ControlCollection coleção de um PlaceHolder controle de servidor Web chamado myPlaceholder.

<%@ Page language="c#" Debug="true" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ASP.NET Example</title>
<script runat="server">
    // System.Web.UI.TemplateControl.ParserControl;
    // The following example demonstrates the method 'ParseControl' of class TemplateControl.
    // Since TemplateControl is abstract, this sample has been written using 'Page' class which derives from 
    // 'TemplateControl' class.
    // A button object is created by passing a string to contstruct a button using ASP syntax, to the 
    // 'ParseControl' method. This button is added as one of the child controls of the page and displayed.
    void Page_Load(object sender, System.EventArgs e)
    {
      Control c = ParseControl("<asp:button text='Click here!' runat='server' />");
      myPlaceholder.Controls.Add(c);
    }
    </script>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:placeholder id ="myPlaceholder" runat="server" />
    </form>
  </body>
</html>

<%@ Page language="vb" Debug="true" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ASP.NET Example</title>
<script runat="server">
    '  System.Web.UI.TemplateControl.ParseControl;
    '  The following example demonstrates the method 'ParseControl' of class TemplateControl.
      
    ' Since TemplateControl is abstract, this sample has been written using 'Page' class which derives from 
    ' 'TemplateControl' class.
    ' A button object is created by passing a string to contstruct a button using ASP syntax, to the 
    ' 'ParseControl' method. This button is added as one of the child controls of the page and displayed.

    Sub Page_Load(sender As Object, e As System.EventArgs)
       Dim c As Control 
       c = ParseControl("<asp:button text='Click here!' runat='server' />")
       myPlaceholder.Controls.Add(c)
    End Sub 'Page_Load
    </script>
  </head>

  <body>
    <form id="form1" runat="server">
      <asp:placeholder id ="myPlaceholder" runat="server" />
    </form>
  </body>
</html>

Comentários

O content parâmetro contém um controle de usuário, como você encontraria em um arquivo .ascx. Essa cadeia de caracteres não pode conter nenhum código, pois o ParseControl método nunca causa compilação.

Confira também

Aplica-se a

ParseControl(String, Boolean)

Analisa uma cadeia de caracteres de entrada em um Control objeto na página da Web ASP.NET ou no controle do usuário.

public:
 System::Web::UI::Control ^ ParseControl(System::String ^ content, bool ignoreParserFilter);
public System.Web.UI.Control ParseControl(string content, bool ignoreParserFilter);
member this.ParseControl : string * bool -> System.Web.UI.Control
Public Function ParseControl (content As String, ignoreParserFilter As Boolean) As Control

Parâmetros

content
String

Uma cadeia de caracteres que contém um controle de usuário.

ignoreParserFilter
Boolean

Um valor que especifica se o filtro do analisador deve ser ignorado.

Retornos

Control

O controle analisado.

Comentários

O content parâmetro contém um controle de usuário (o conteúdo de um arquivo .ascx). Essa cadeia de caracteres não pode conter nenhum código, pois o ParseControl método nunca causa compilação.

O ignoreParserFilter parâmetro permite que a PageParserFilter classe seja ignorada. A classe PageParserFilter é usada pelo analisador ASP.NET para determinar se um item é permitido na página em tempo de análise.

Aplica-se a