WebControl.AddAttributesToRender(HtmlTextWriter) 메서드

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.dll

지정된 HtmlTextWriterTag에 렌더링되어야 하는 HTML 특성 및 스타일을 추가합니다. 이 메서드는 주로 컨트롤 개발자에 의해 사용됩니다.

protected:
 virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);

protected virtual void AddAttributesToRender (System.Web.UI.HtmlTextWriter writer);

abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit

Protected Overridable Sub AddAttributesToRender (writer As HtmlTextWriter)

매개 변수

writer

HtmlTextWriter

클라이언트에서 HTML 콘텐츠를 렌더링하기 위한 출력 스트림을 나타내는 HtmlTextWriter입니다.

예제

다음 예제에서 파생 되는 클래스를 만들어야 하는 방법에 설명 합니다 WebControl 클래스입니다. 기본 구현을 합니다 AddAttributesToRender 메서드를 재정의에서 파생된 된 클래스에 적절 한 특성을 추가 하는 HtmlTextWriter 출력 스트림에 합니다.

namespace ControlTest 
{
   using System;
   using System.Web.UI;
   using System.Web.UI.WebControls;

   // Renders the following HTML: 
   // <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>

   public class MyWebControl: WebControl {

      public MyWebControl() : base(HtmlTextWriterTag.Span) 
      { }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void AddAttributesToRender(HtmlTextWriter writer) 
      {

         writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
         writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
         base.AddAttributesToRender(writer);
      }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void RenderContents(HtmlTextWriter writer) 
      {
         writer.Write("Custom Contents");
         base.RenderContents(writer);
      }
   }
}

Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace ControlTest
   
   ' Renders the following HTML: 
   ' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
   Public Class MyWebControl
      Inherits WebControl
      
      
      Public Sub New()
         MyBase.New(HtmlTextWriterTag.Span)
      End Sub
      
      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
         
         writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
         writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
         MyBase.AddAttributesToRender(writer)

      End Sub

      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
         writer.Write("Custom Contents")
         MyBase.RenderContents(writer)
      End Sub

   End Class

End Namespace 'ControlTest

설명

특성 및 클라이언트에서 웹 서버 컨트롤의 스타일을 렌더링 하려면 일반적으로 호출 합니다 AddAttribute 및 HtmlTextWriter.AddStyleAttribute 각 삽입 하는 메서드 특성 및 스타일 지정에 개별적으로 HtmlTextWriter 출력 스트림에 합니다. 이 메서드는 프로세스를 간소화 하기에 대 한 모든 호출을 캡슐화 합니다 HtmlTextWriter.AddAttribute 및 HtmlTextWriter.AddStyleAttribute 모든 특성 및 웹 서버 컨트롤과 연결 된 스타일에 대 한 메서드. 모든 특성 및 스타일에 삽입 되는 HtmlTextWriter 단일 메서드 호출의 출력 스트림을 합니다. 이 메서드는 파생된 클래스에서 적절 한 특성을 삽입할 컨트롤 개발자가 일반적으로 재정의 됩니다 하 고 스타일을 HtmlTextWriter 클래스에 대 한 출력 스트림 합니다.

참고

AddAttributesToRender 클라이언트 스크립트를 삽입 하는 메서드를 사용할 수 없습니다. 클라이언트 스크립트를 사용 하려면 참조는 ClientScriptManager 클래스입니다.

추가 정보

• AddAttribute
• AddStyleAttribute
• HtmlTextWriter
• 사용자 지정 ASP.NET 서버 컨트롤 개발