Compartilhar via


TemplateControl.ParseControl Método

Definição

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

Sobrecargas

ParseControl(String)

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

ParseControl(String, Boolean)

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

Comentários

ParseControlé introduzido no .NET Framework versão 3.5. Para saber mais, confira Versões e dependências.

ParseControl(String)

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

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 Control analisado.

Exemplos

O exemplo de código a seguir demonstra como criar um Button controle de servidor Web usando o ParseControl método e, em seguida, 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 a compilação.

Confira também

Aplica-se a

ParseControl(String, Boolean)

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

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 de 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 a compilação.

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

Aplica-se a