Deklarative Syntax des HtmlGenericControl-Serversteuerelements
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Erstellt ein serverseitiges Steuerelement, das einem HTML-Element zugeordnet wird, das nicht durch eine spezielle .NET Framework-Klasse dargestellt wird, z. B. <body> oder <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>
Hinweise
Dieses Steuerelement wird auf dem Server als Reaktion auf Tags erstellt, die das runat="server"-Attribut-Wert-Paar in Elementen enthalten, die nicht direkt einem bestimmten HTML-Steuerelement zugeordnet sind. Zu diesen Elementen zählen unter anderem die Elemente <span>, <body>, <div> und <font>. Das Steuerelement ordnet ASP.NET den Tagnamen des betreffenden Elements, das als HTML-Steuerelement verwendet werden soll, mithilfe der TagName-Eigenschaft zu. Dieses Steuerelement erbt Funktionalität von der HtmlContainerControl-Klasse, sodass Sie den inneren Inhalt von HTML-Steuerelementtags dynamisch ändern können.
Mit einem serverseitigen <span>-Element können Sie Text anzeigen, der durch Ereignishandlercode generiert wurde, sei es durch Benutzereingabe oder aus einer Quelle, die Sie im Ereignishandler angegeben haben. Außerdem können Sie mit dem Page_Load-Ereignis Text in einem span-Steuerelement sowie HTML-Stilattribute generieren, um den Text bei der Anzeige im Browser zu formatieren.
Beispiel
Das folgende Beispiel veranschaulicht das Generieren von anzuzeigendem Text, der auf der Benutzereingabe in einem HtmlInputText-Steuerelement basiert. Das HtmlGenericControl, das durch Deklaration des <span>-Elements auf der Seite erstellt wird, stellt dem <span>-Element den Zugriff auf die InnerHtml-Eigenschaft zur Verfügung. Dadurch können Sie die im <span>-Element enthaltene Textzeichenfolge bearbeiten.
<%@ 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>
Das folgende Beispiel veranschaulicht, wie Sie mit einem HtmlGenericControl festlegen können, dass ein Benutzer die Hintergrundfarbe einer Seite bearbeiten darf. Es zeigt außerdem die Verwendung der AttributeCollection-Klasse zum programmgesteuerten Zugriff auf die Attribute, die für jedes HTML-Steuerelement deklariert werden können.
<%@ 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>