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
• アダプティブ制御動作のアーキテクチャの概要