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

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

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

注意 (継承者)

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

こちらもご覧ください

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