HtmlGenericControl 伺服器控制項宣告式語法

發行項
08/12/2011

建立伺服器端控制項，使其對應至不由特定 .NET Framework 類別所表示的 HTML 項目，例如 <body> 和 <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>

備註

這個控制項會在伺服器上建立，以回應在項目中包含 runat="server" 屬性/值組的標記，而這些項目並不直接對應至特定的 HTML 控制項。這些項目包括 <span>、<body>、<div>、<font> 項目和其他的項目。此控制項會透過 TagName 屬性，將要做為 HTML 控制項之特定項目的標記名稱對應至 ASP.NET。這個控制項會從 HtmlContainerControl 類別繼承功能，該類別讓您能夠動態地變更 HTML 控制項標記的內部內容。

不論是透過使用者輸入，或是從事件處理常式中指定的來源，您都可以使用伺服器端 <span> 項目，來顯示事件處理常式程式碼所產生的文字。您也可以使用 Page_Load 事件來產生 span 控制項中的文字和 HTML 樣式屬性，以格式化顯示在瀏覽器中的文字。

範例

下列範例會示範如何根據 HtmlInputText 控制項中的使用者輸入，來產生要顯示的文字。藉由在網頁上宣告 <span> 項目而建立的 HtmlGenericControl 會提供 <span> 項目 InnerHtml 屬性的存取權。這樣就讓您能夠處理指派至 <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>

下列範例會示範如何使用 HtmlGenericControl，以允許使用者修改網頁的背景色彩。並且示範如何使用 AttributeCollection 類別，以程式設計方式存取可以在任何 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>

共用方式為

HtmlGenericControl 伺服器控制項宣告式語法

備註

範例

請參閱

參考

其他資源

其他資源