Share via


Sintaxe declarativa do controle de servidor de HtmlGenericControl

Cria um controle de servidor que mapeia para um elemento HTML não representado por uma determinada.NET Framework classes, como <body> e <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>

Comentários

Esse controle é criado no servidor em resposta às marcas que incluem o runat="server" atributo/valor par nos elementos que mapeiam diretamente a um controle HTML específicos. Esses elementos incluem o <span>, <body>, <div>, e <font> elementos, entre outros. O controle mapeia o nome da marca do elemento específico a ser usado como um controle HTML para o ASP.NET por meio de TagName propriedade. Esse controle herda a funcionalidade a partir de HtmlContainerControl classe, que lhe permite alterar dinamicamente o conteúdo interno de marcas de controle HTML.

Você pode usar um servidor <span> elemento para exibir o texto gerado pelo código de manipulador de eventos, seja por meio de entrada de usuário ou de uma fonte que você designar no seu manipulador de eventos. Você também pode usar o Page_Load o evento para gerar o texto em um controle de intervalo e atributos de estilo HTML para formatar o texto quando ela é exibida no navegador.

Exemplo

O exemplo a seguir mostra como você pode gerar o texto a ser exibido com base na entrada do usuário em um HtmlInputText de controle. O HtmlGenericControl, que é criado, declarando a <span> elemento na página, fornece o <span> o elemento com acesso ao InnerHtml propriedade. Isso lhe permite manipular a seqüência de caracteres de texto atribuída para o <span> elemento.

<%@ 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>

O exemplo a seguir mostra como você pode usar um HtmlGenericControl para permitir que um usuário modificar a cor de plano de fundo de. uma página Ele também mostra como usar o AttributeCollection a classe para acessar programaticamente os atributos que podem ser declarados em qualquer controle 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>

Consulte também

Referência

HtmlGenericControl

Outros recursos

HTML Server Controls