Syntaxe déclarative du contrôle serveur HtmlGenericControl
Crée un contrôle côté serveur mappé à un élément HTML non représenté par une classe .NET Framework spécifique, par exemple <body> et <div>.
<span | body | div | font | others
EnableViewState="False|True"
ID="string"
OnDataBinding="OnDataBinding event handler"
OnDisposed="OnDisposed"
OnInit="OnInit event handler"
OnLoad="OnLoad event handler"
OnPreRender="OnPreRender event handler"
OnServerClick="OnServerClick event handler"
OnUnload="OnUnload event handler"
runat="server"
Visible="False|True" >
contentBetweenTags
</span | body | div | font | others>
Notes
Ce contrôle est créé sur le serveur en réponse aux balises qui incluent la paire attribut/valeur runat="server" dans les éléments qui ne sont pas directement mappés à un contrôle HTML spécifique. Ces éléments comprennent, entre autres, les éléments <span>, <body>, <div> et <font>. Le contrôle associe le nom de balise d'un élément particulier à utiliser en tant que contrôle HTML à ASP.NET via la propriété TagName. Ce contrôle hérite des fonctionnalités de la classe HtmlContainerControl qui permet de modifier de façon dynamique le contenu interne des balises de contrôle HTML.
Vous pouvez utiliser un élément <span> côté serveur pour afficher un texte généré par du code de gestionnaire d'événements, via une entrée d'utilisateur ou une source que vous désignez dans votre gestionnaire d'événements. Vous pouvez également utiliser l'événement Page_Load pour générer du texte dans un contrôle span et des attributs de style HTML pour mettre en forme le texte lorsqu'il s'affiche dans le navigateur.
Exemple
L'exemple suivant montre comment générer le texte à afficher à partir de l'entrée d'utilisateur dans un contrôle HtmlInputText. Le contrôle HtmlGenericControl, qui est créé en déclarant l'élément <span> sur la page, fournit l'élément <span> avec accès à la propriété InnerHtml. Cela vous permet de manipuler la chaîne de texte assignée à l'élément <span>.
<%@ Page Language="VB" AutoEventWireup="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>HtmlGenericControl Control</title>
<script runat="server">
Sub SubmitBtn_Click(Source As Object, e As EventArgs)
MySpan.InnerHtml = "Welcome to ASP.NET, " & myText.Value & "."
End Sub
</script>
</head>
<body>
<form id="myForm" runat="server">
<br />
Enter your name here:
<input type="text" id="myText" runat="server" />
<br /><br />
<input id="Submit1" type="submit" value="Click Here!"
onserverclick="SubmitBtn_Click" runat="server" />
<br /><br />
<b><span id="MySpan" runat="server"/></b>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="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>HtmlGenericControl Control</title>
<script runat="server">
void SubmitBtn_Click(object Source, EventArgs e)
{
MySpan.InnerHtml = "Welcome to ASP.NET, " + myText.Value + ".";
}
</script>
</head>
<body>
<form id="myForm" runat="server">
<br />Enter your name here:
<input type="text" id="myText" runat="server" />
<br /><br />
<input id="Submit1" type="submit" value="Click Here!"
onserverclick="SubmitBtn_Click" runat="server" />
<br /><br />
<b><span id="MySpan" runat="server"/></b>
</form>
</body>
</html>
L'exemple suivant montre comment utiliser un contrôle HtmlGenericControl pour permettre à un utilisateur de modifier la couleur d'arrière-plan d'une page. Il montre également comment utiliser la classe AttributeCollection pour accéder par programme aux attributs qui peuvent être déclarés sur un contrôle HTML.
<%@ Page Language="VB" AutoEventWireup="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>HtmlGenericControl Control</title>
<script runat="server">
Sub SubmitBtn_Click(Source As Object, e As EventArgs)
Body.Attributes("bgcolor") = ColorSelect.Value
End Sub
</script>
</head>
<body id="Body" runat="server">
<h3>Updating Styles with the HtmlGenericControl</h3>
<form id="Form1" runat="server">
<br />
Select a background color for the page: <br />
<select id="ColorSelect" runat="server">
<option>White</option>
<option>Wheat</option>
<option>Gainsboro</option>
<option>LemonChiffon</option>
</select>
<input id="Submit1" type="submit" runat="server"
value="Apply" onserverclick="SubmitBtn_Click" />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="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>HtmlGenericControl Control</title>
<script runat="server">
void SubmitBtn_Click(object Source, EventArgs e)
{
Body.Attributes["bgcolor"] = ColorSelect.Value;
}
</script>
</head>
<body id="Body" runat="server">
<h3>Updating Styles with the HtmlGenericControl</h3>
<form id="Form1" runat="server">
<br />
Select a background color for the page: <br />
<select id="ColorSelect" runat="server">
<option>White</option>
<option>Wheat</option>
<option>Gainsboro</option>
<option>LemonChiffon</option>
</select>
<input id="Submit1" type="submit" runat="server"
value="Apply" onserverclick="SubmitBtn_Click" />
</form>
</body>
</html>