TemplateControl.ParseControl Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Analisa uma cadeia de entrada num objeto Control na página Web ASP.NET ou controlo do utilizador.

Sobrecargas

Name Description
ParseControl(String)

Analisa uma cadeia de entrada num Control objeto na página Web Forms ou no controlo do utilizador.
ParseControl(String, Boolean)

Analisa uma cadeia de entrada num objeto Control na página Web ASP.NET ou controlo do utilizador.

Observações

ParseControl é introduzido na versão 3.5 do .NET Framework. Para mais informações, consulte Versões e Dependências.

ParseControl(String)

Analisa uma cadeia de entrada num Control objeto na página Web Forms ou no controlo do utilizador.

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 que contém um controlo do utilizador.

Devoluções

Control

A análise Controlanalisada .

Exemplos

O exemplo de código seguinte demonstra como criar um Button controlo de servidor Web usando o ParseControl método, e depois adiciona o resultado à ControlCollection coleção de um PlaceHolder controlo 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>

Observações

O content parâmetro contém um controlo do utilizador, como o que encontraria num ficheiro .ascx. Esta cadeia não pode conter qualquer código, porque o ParseControl método nunca causa compilação.

Ver também

Aplica-se a

ParseControl(String, Boolean)

Analisa uma cadeia de entrada num objeto Control na página Web ASP.NET ou controlo do utilizador.

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 que contém um controlo do utilizador.

ignoreParserFilter
Boolean

Um valor que especifica se deve ignorar o filtro do parser.

Devoluções

Control

O controlo analisado.

Observações

O content parâmetro contém um controlo do utilizador (o conteúdo de um ficheiro .ascx). Esta cadeia não pode conter qualquer código, porque o ParseControl método nunca causa compilação.

O ignoreParserFilter parâmetro permite ignorar a PageParserFilter classe. 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