TemplateControl.ParseControl Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 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
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.