TemplateControl.ParseControl Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

Analyse une chaîne d'entrée dans un objet Control sur la page Web ASP.NET ou le contrôle utilisateur.

Surcharges

ParseControl(String)

Analyse une chaîne d'entrée dans un objet Control sur la page Web Forms ou le contrôle utilisateur.
ParseControl(String, Boolean)

Analyse une chaîne d'entrée dans un objet Control sur la page Web ASP.NET ou le contrôle utilisateur.

Remarques

ParseControlest introduit dans la .NET Framework version 3.5. Pour plus d’informations, consultez Versions et dépendances.

ParseControl(String)

Analyse une chaîne d'entrée dans un objet Control sur la page Web Forms ou le contrôle utilisateur.

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

Paramètres

content
String

Chaîne qui contient un contrôle utilisateur.

Retours

Control

Control analysé.

Exemples

L’exemple de code suivant montre comment créer un Button contrôle serveur Web à l’aide de la ParseControl méthode, puis ajouter le résultat à la ControlCollection collection d’un PlaceHolder contrôle serveur Web nommé 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>

Remarques

Le content paramètre contient un contrôle utilisateur, tel que vous le trouverez dans un fichier .ascx. Cette chaîne ne peut contenir aucun code, car la méthode n’entraîne jamais la ParseControl compilation.

Voir aussi

S’applique à

ParseControl(String, Boolean)

Analyse une chaîne d'entrée dans un objet Control sur la page Web ASP.NET ou le contrôle utilisateur.

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

Paramètres

content
String

Chaîne qui contient un contrôle utilisateur.

ignoreParserFilter
Boolean

Valeur qui spécifie s'il faut ignorer le filtre de l'analyseur.

Retours

Control

Contrôle analysé.

Remarques

Le content paramètre contient un contrôle utilisateur (le contenu d’un fichier .ascx). Cette chaîne ne peut contenir aucun code, car la méthode n’entraîne jamais la ParseControl compilation.

Le ignoreParserFilter paramètre permet à la PageParserFilter classe d’être ignorée. La PageParserFilter classe est utilisée par l’analyseur ASP.NET pour déterminer si un élément est autorisé dans la page au moment de l’analyse.

S’applique à