Deklarativní syntaxe ovládacího prvku HtmlGenericControl webového serveru

Článek
08/11/2011

Vytvoří serverový ovládací prvek, který se mapuje na prvek jazyka HTML, který není reprezentován konkrétní třídou rozhraní .NET Framework, jako například <body> a <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>

Poznámky

Tento ovládací prvek je vytvořen na serveru v odpovědi na značky, které zahrnují dvojici atribut/hodnotu runat="server" v prvcích, které se nemapují přímo na určitý ovládací prvek HTML. Tyto prvky mimo jiné obsahují prvky <span>, <body>, <div> a <font>. Ovládací prvek mapuje název značky určitého prvku pro jeho použití jako ovládacího prvku HTML na ASP.NET prostřednictvím vlastnosti TagName. Tento ovládací prvek dědí funkce třídy HtmlContainerControl, která umožňuje dynamicky měnit vnitřní obsah značek ovládacího prvku HTML.

Můžete použít serverový prvek <span> pro zobrazení textu generovaného kódem obslužné rutiny události, buď prostřednictvím vstupu uživatele nebo ze zdroje, který určíte ve vaší obslužné rutině události. Můžete také použít událost Page_Load pro vygenerování textu v ovládacím prvku span a atributů stylu jazyka HTML pro formátování textu při jeho zobrazení v prohlížeči.

Příklad

Následující příklad ukazuje, jak můžete vygenerovat text pro zobrazení založený na vstupu uživatele v ovládacím prvku HtmlInputText. HtmlGenericControl, který je vytvořen deklarací elementu <span> na stránce, poskytuje prvek <span> s přístupem k vlastnosti InnerHtml. To umožňuje manipulaci s textovým řetězcem přiřazeným elementu <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>

Následující příklad ukazuje použití HtmlGenericControl pro povolení uživateli změnit barvu pozadí stránky. Také ukazuje, jak používat třídu AttributeCollection pro programový přístup k atributům, které lze deklarovat u libovolného ovládacího prvku jazyka 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>

Sdílet prostřednictvím

Deklarativní syntaxe ovládacího prvku HtmlGenericControl webového serveru

Poznámky

Příklad

Viz také

Odkaz

Další zdroje

Další materiály