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 要求資訊。 屬性 Adapter 會傳 ControlAdapter 回 物件，這個物件會轉譯要求裝置或瀏覽器畫面上的控件。

如需配接器的詳細資訊，請參閱 調適型控件行為的架構概觀。

如果伺服器控制件的 Visible 屬性設定 true 為 ，且已啟用頁面的追蹤，則會擷取與控件相關聯的追蹤資訊。

給繼承者的注意事項

在 RenderControl(HtmlTextWriter, ControlAdapter) 自定義控件中覆寫 方法時，請呼叫基類方法，以確保正確擷取追蹤資訊。

另請參閱

• Adapter
• ControlAdapter
• Trace
• 自適性控制行為的架構概觀