Control.RenderControl 메서드

정의

서버 컨트롤 콘텐츠를 출력하고, 추적 기능이 설정된 경우에는 컨트롤에 대한 추적 정보를 저장합니다.Outputs server control content and stores tracing information about the control if tracing is enabled.

오버로드

RenderControl(HtmlTextWriter)

제공된 HtmlTextWriter 개체로 서버 컨트롤 콘텐츠를 출력하고 추적을 사용하는 경우 컨트롤에 대한 추적 정보를 저장합니다.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter)

제공된 HtmlTextWriter 개체를 사용하여 제공된 ControlAdapter 개체에 서버 컨트롤 콘텐츠를 출력합니다.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter)

제공된 HtmlTextWriter 개체로 서버 컨트롤 콘텐츠를 출력하고 추적을 사용하는 경우 컨트롤에 대한 추적 정보를 저장합니다.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

public:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public void RenderControl (System.Web.UI.HtmlTextWriter writer);
public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);
member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
Public Sub RenderControl (writer As HtmlTextWriter)
Public Overridable Sub RenderControl (writer As HtmlTextWriter)

매개 변수

writer
HtmlTextWriter

컨트롤 콘텐츠를 받는 HtmlTextWriter 개체입니다.The HtmlTextWriter object that receives the control content.

예제

다음 예제에서는 사용자 지정 서버 컨트롤의 RenderChildren 메서드를 재정의 합니다.The following example overrides the RenderChildren method in a custom server control. 현재 컨트롤의 ControlCollection 개체에 자식 컨트롤이 있는지 여부를 확인 합니다.It determines whether the current control has any child controls in its ControlCollection object. 이 경우 Count 속성을 사용 하 여 컬렉션을 반복 합니다.If it does, it uses the Count property to iterate through the collection. 각 자식 컨트롤이 발견 되 면 RenderControl 메서드를 사용 하 여 자식 컨트롤과 모든 자식 컨트롤을 포함 하는 페이지에 렌더링 합니다.As it encounters each child control, it uses the RenderControl method to render the child control, and all of its child controls, to the containing page. 이 메서드에 전달 되는 XhtmlTextWriter 개체는 Render 메서드에 의해 인스턴스화됩니다.The XhtmlTextWriter object that is passed to this method is instantiated by the Render method.

// Override default implementation to Render children according to needs. 
protected override void RenderChildren(HtmlTextWriter output)
{
   if (HasControls())
   {
      // Render Children in reverse order.
      for(int i = Controls.Count - 1; i >= 0; --i)
      {
         Controls[i].RenderControl(output);
      }
   }         
}

protected override void Render(HtmlTextWriter output)
{       
   output.Write("<br>Message from Control : " + Message);       
   output.Write("Showing Custom controls created in reverse" +
                                                    "order");         
   // Render Controls.
   RenderChildren(output);
}
' Override default implementation to Render children according to needs. 
      Protected Overrides Sub RenderChildren(output As HtmlTextWriter)
         If HasControls() Then
            ' Render Children in reverse order.
            Dim i As Integer

            For i = Controls.Count - 1 To 0 Step -1
               Controls(i).RenderControl(output)
            Next

         End If
      End Sub
      
      
      Protected Overrides Sub Render(output As HtmlTextWriter)
         output.Write(("<br>Message from Control : " + Message))
         output.Write(("Showing Custom controls created in reverse" + "order"))
         ' Render Controls.
         RenderChildren(output)
      End Sub
   End Class

설명

서버 컨트롤의 Visible 속성이 true로 설정 된 경우이 메서드는 페이지에 추적을 사용할 수 있는지 여부를 확인 합니다.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. 그렇다면 컨트롤과 연결 된 추적 정보를 저장 하 고 페이지에 서버 컨트롤 콘텐츠를 렌더링 합니다.If so, it stores trace information associated with the control, and renders the server control content to the page.

이 메서드를 렌더링 하는 동안 페이지에서 자동으로 호출 하지만 사용자 지정 컨트롤 개발자가 재정의할 수 있습니다.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

추가 정보

RenderControl(HtmlTextWriter, ControlAdapter)

제공된 HtmlTextWriter 개체를 사용하여 제공된 ControlAdapter 개체에 서버 컨트롤 콘텐츠를 출력합니다.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

protected:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);
protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);
member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit
Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)

매개 변수

writer
HtmlTextWriter

컨트롤 콘텐츠를 받는 HtmlTextWriter입니다.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter

렌더링을 정의하는 ControlAdapter입니다.The ControlAdapter that defines the rendering.

설명

ASP.NET 웹 페이지 광범위 한 장치 및 웹에서 정보를 요청할 수 있는 브라우저에서 사용할 수 있습니다.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. Adapter 속성에서 반환 된 ControlAdapter 요청 하는 디바이스 또는 브라우저의 화면에 컨트롤을 렌더링 하는 개체입니다.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

어댑터에 대 한 자세한 내용은 적응 제어 동작의 아키텍처 개요를 참조 하세요.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

서버 컨트롤의 Visible 속성이 true로 설정 되 고 페이지에 추적을 사용 하도록 설정 된 경우 컨트롤과 연결 된 추적 정보가 캡처됩니다.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

상속자 참고

사용자 지정 컨트롤에서 RenderControl(HtmlTextWriter, ControlAdapter) 메서드를 재정의 하는 경우 기본 클래스 메서드를 호출 하 여 추적 정보가 올바르게 캡처되고 있는지 확인 합니다.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

추가 정보

적용 대상