Deklarative Syntax des HtmlGenericControl-Serversteuerelements

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>

Siehe auch

Referenz

HtmlGenericControl

Weitere Ressourcen

HTML-Serversteuerelemente

Last updated on 2011-08-10

Freigeben über