Compartir a través de


TemplateControl.ParseControl Método

Definición

Analiza una cadena de entrada en un objeto Control en la página web o control de usuario ASP.NET.

Sobrecargas

ParseControl(String)

Analiza una cadena de entrada en un objeto Control en la página o control de usuario de formularios Web Forms.

ParseControl(String, Boolean)

Analiza una cadena de entrada en un objeto Control en la página web o control de usuario ASP.NET.

Comentarios

ParseControl se presenta en la versión 3.5 de .NET Framework. Para más información, vea Versiones y dependencias.

ParseControl(String)

Analiza una cadena de entrada en un objeto Control en la página o control de usuario de formularios 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

Cadena que contiene un control de usuario.

Devoluciones

El objeto Control analizado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un Button control de servidor web mediante el ParseControl método y, a continuación, se agrega el resultado a la ControlCollection colección de un PlaceHolder control de servidor web denominado 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>

Comentarios

El content parámetro contiene un control de usuario, como encontraría en un archivo .ascx. Esta cadena no puede contener ningún código, ya que el ParseControl método nunca provoca la compilación.

Consulte también

Se aplica a

ParseControl(String, Boolean)

Analiza una cadena de entrada en un objeto Control en la página web o control de usuario 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

Cadena que contiene un control de usuario.

ignoreParserFilter
Boolean

Valor que especifica si se omite el filtro del analizador.

Devoluciones

Control analizado.

Comentarios

El content parámetro contiene un control de usuario (el contenido de un archivo .ascx). Esta cadena no puede contener ningún código, ya que el ParseControl método nunca provoca la compilación.

El ignoreParserFilter parámetro permite omitir la PageParserFilter clase. El PageParserFilter analizador de ASP.NET usa la clase para determinar si se permite un elemento en la página en tiempo de análisis.

Se aplica a