Control.RenderControl メソッド

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)

パラメーター

例

次の例では、 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

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)

パラメーター

注釈

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

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

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

注意 (継承者)

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

こちらもご覧ください

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