HtmlGenericControl 서버 컨트롤 선언 구문

아티클
09/05/2008

업데이트: 2007년 11월

<body> 및 <div>처럼 특정 .NET Framework 클래스로 표시되지 않는 HTML 요소에 매핑되는 서버측 컨트롤을 만듭니다.

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

설명

이 컨트롤은 특정 HTML 컨트롤에 직접 매핑되지 않는 요소에서 runat="server" 특성 값/쌍을 포함하는 태그에 대한 응답으로 서버에서 만들어집니다. 이러한 컨트롤에는 <span>, <body>, <div>, <font> 요소 등이 포함됩니다. 이 컨트롤은 TagName 속성을 통해 HTML 컨트롤로 사용할 특정 요소의 태그 이름을 ASP.NET에 매핑합니다. 이 컨트롤은 HTML 컨트롤 태그의 내부 내용을 동적으로 변경하는 데 사용할 수 있는 HtmlContainerControl 클래스에서 기능을 상속합니다.

서버측 <span> 요소를 사용하면 사용자 입력 또는 이벤트 처리기에 지정된 소스를 통해 이벤트 처리기 코드에서 생성하는 텍스트를 표시할 수 있습니다. 또한 Page_Load 이벤트를 사용하면 텍스트를 span 컨트롤 또는 HTML 스타일 특성으로 생성하여 해당 텍스트가 브라우저에 표시되는 경우 적용할 서식을 지정할 수 있습니다.

예제

다음 예제에서는 사용자가 HtmlInputText 컨트롤에 입력하는 내용에 따라 표시할 텍스트를 생성하는 방법을 보여 줍니다. 페이지에 <span> 요소를 선언하여 만들어지는 HtmlGenericControl은 InnerHtml 속성에 액세스할 수 있는 <span> 요소를 제공합니다. 이렇게 하면 <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 컨트롤을 사용하여 사용자가 페이지의 배경색을 변경할 수 있도록 하는 방법을 보여 줍니다. 또한 모든 HTML 컨트롤에 선언할 수 있는 특성에 프로그래밍 방식으로 액세스하기 위해 AttributeCollection 클래스를 사용하는 방법도 보여 줍니다.

<%@ 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 서버 컨트롤 선언 구문

설명

예제

참고 항목

참조

기타 리소스

추가 리소스