Control.RenderControl メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。

オーバーロード

RenderControl(HtmlTextWriter)	指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。
RenderControl(HtmlTextWriter, ControlAdapter)	指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。

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)

指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。

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 Web ページは、Web から情報を要求できるさまざまなデバイスやブラウザーで使用できます。 プロパティは Adapter 、要求する ControlAdapter デバイスまたはブラウザーの画面にコントロールをレンダリングする オブジェクトを返します。

アダプターの詳細については、「 アダプティブ コントロール動作のアーキテクチャの概要」を参照してください。

サーバー コントロールの Visible プロパティが に設定され、ページに対して true トレースが有効になっている場合、コントロールに関連付けられているトレース情報がキャプチャされます。

注意 (継承者)

カスタム コントロールで メソッドを RenderControl(HtmlTextWriter, ControlAdapter) オーバーライドする場合は、基本クラス メソッドを呼び出して、トレース情報が正しくキャプチャされるようにします。

こちらもご覧ください

• Adapter
• ControlAdapter
• Trace
• アダプティブ 制御動作のアーキテクチャの概要