Control.RenderControl 메서드

정의

네임스페이스:

System.Web.UI

어셈블리:

System.Web.dll

서버 컨트롤 콘텐츠를 출력하고, 추적 기능이 설정된 경우에는 컨트롤에 대한 추적 정보를 저장합니다.

오버로드

RenderControl(HtmlTextWriter)	제공된 HtmlTextWriter 개체로 서버 컨트롤 콘텐츠를 출력하고 추적을 사용하는 경우 컨트롤에 대한 추적 정보를 저장합니다.
RenderControl(HtmlTextWriter, ControlAdapter)	제공된 HtmlTextWriter 개체를 사용하여 제공된 ControlAdapter 개체에 서버 컨트롤 콘텐츠를 출력합니다.

RenderControl(HtmlTextWriter)

제공된 HtmlTextWriter 개체로 서버 컨트롤 콘텐츠를 출력하고 추적을 사용하는 경우 컨트롤에 대한 추적 정보를 저장합니다.

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);

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

Public Overridable Sub RenderControl (writer As HtmlTextWriter)

매개 변수

writer

HtmlTextWriter

컨트롤 콘텐츠를 받는 HtmlTextWriter 개체입니다.

예제

다음 예제에서는 사용자 지정 서버 컨트롤에서 RenderChildren 메서드를 재정의합니다. 현재 컨트롤의 개체에 자식 컨트롤이 있는지 여부를 결정합니다 ControlCollection . 이 경우 속성을 사용하여 Count 컬렉션을 반복합니다. 각 자식 컨트롤이 발견되면 메서드를 RenderControl 사용하여 자식 컨트롤과 모든 자식 컨트롤을 포함하는 페이지로 렌더링합니다. 이 XhtmlTextWriter 메서드에 전달되는 개체는 메서드에 Render 의해 인스턴스화됩니다.

// 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경우 이 메서드는 페이지에 대해 추적을 사용할 수 있는지 여부를 결정합니다. 이 경우 컨트롤과 연결된 추적 정보를 저장하고 서버 컨트롤 콘텐츠를 페이지로 렌더링합니다.

이 메서드는 렌더링하는 동안 페이지에서 자동으로 호출되지만 사용자 지정 컨트롤 개발자가 재정의할 수 있습니다.

추가 정보

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

제공된 HtmlTextWriter 개체를 사용하여 제공된 ControlAdapter 개체에 서버 컨트롤 콘텐츠를 출력합니다.

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입니다.

adapter

ControlAdapter

렌더링을 정의하는 ControlAdapter입니다.

설명

ASP.NET 웹 페이지 광범위 한 디바이스 및 웹에서 정보를 요청할 수 있는 브라우저에서 사용할 수 있습니다. Adapter 속성에서 반환 된 ControlAdapter 요청 하는 디바이스 또는 브라우저의 화면에 컨트롤을 렌더링 하는 개체입니다.

어댑터에 대한 자세한 내용은 적응형 컨트롤 동작의 아키텍처 개요를 참조하세요.

서버 컨트롤의 Visible 속성을 로 true 설정하고 페이지에 대해 추적을 사용하도록 설정하면 컨트롤과 연결된 추적 정보가 캡처됩니다.

상속자 참고

사용자 지정 컨트롤에서 메서드를 재정의 RenderControl(HtmlTextWriter, ControlAdapter) 할 때 기본 클래스 메서드를 호출하여 추적 정보가 올바르게 캡처되었는지 확인합니다.

추가 정보

• Adapter
• ControlAdapter
• Trace
• 적응형 컨트롤 동작의 아키텍처 개요