TemplateControl.ParseControl Method

Definition

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web ASP.NET.Parses an input string into a Control object on the ASP.NET Web page or user control.

Overloads

ParseControl(String)

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web Form.Parses an input string into a Control object on the Web Forms page or user control.

ParseControl(String, Boolean)

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web ASP.NET.Parses an input string into a Control object on the ASP.NET Web page or user control.

Remarks

ParseControl è stato introdotto nella versione .NET Framework 3,5.ParseControl is introduced in the .NET Framework version 3.5. Per altre informazioni, vedere Versioni e dipendenze.For more information, see Versions and Dependencies.

ParseControl(String)

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web Form.Parses an input string into a Control object on the Web Forms page or user control.

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

Parameters

content
String

Stringa contenente un controllo utente.A string that contains a user control.

Returns

Control

Oggetto Control analizzato.The parsed Control.

Examples

Nell'esempio di codice seguente viene illustrato come creare un controllo server Web Button utilizzando il metodo ParseControl, quindi viene aggiunto il risultato alla raccolta ControlCollection di un controllo server Web PlaceHolder denominato myPlaceholder.The following code example demonstrates how to create a Button Web server control using the ParseControl method, and then adds the result to the ControlCollection collection of a PlaceHolder Web server control named 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>

Remarks

Il parametro content contiene un controllo utente, ad esempio in un file con estensione ascx.The content parameter contains a user control, such as you would find in an .ascx file. Questa stringa non può contenere codice, perché il metodo ParseControl non causa mai la compilazione.This string cannot contain any code, because the ParseControl method never causes compilation.

See also

ParseControl(String, Boolean)

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web ASP.NET.Parses an input string into a Control object on the ASP.NET Web page or user control.

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

Parameters

content
String

Stringa contenente un controllo utente.A string that contains a user control.

ignoreParserFilter
Boolean

Valore che specifica se ignorare il filtro del parser.A value that specifies whether to ignore the parser filter.

Returns

Control

Controllo analizzato.The parsed control.

Remarks

Il parametro content contiene un controllo utente (il contenuto di un file con estensione ascx).The content parameter contains a user control (the contents of an .ascx file). Questa stringa non può contenere codice, perché il metodo ParseControl non causa mai la compilazione.This string cannot contain any code, because the ParseControl method never causes compilation.

Il ignoreParserFilter parametro consente di ignorare la classe PageParserFilter.The ignoreParserFilter parameter allows the PageParserFilter class to be ignored. La classe PageParserFilter viene utilizzata dal parser ASP.NET per determinare se un elemento è consentito nella pagina in fase di analisi.The PageParserFilter class is used by the ASP.NET parser to determine whether an item is allowed in the page at parse time.

Applies to