語言

HideDisabledControlAdapter.Render(HtmlTextWriter) 方法

定義

將相關的 Web 控制項寫入輸出串流,格式為 HTML。

protected public:
 override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected internal override void Render(System.Web.UI.HtmlTextWriter writer);
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Friend Overrides Sub Render (writer As HtmlTextWriter)

參數

writer
HtmlTextWriter

HtmlTextWriter包含建構與渲染特定裝置輸出的方法。

範例

以下程式碼範例示範如何覆寫 Render 將物件傳給 HtmlTextWriter 父控制項以進行渲染的方法,前提是相關控制項已啟用。 此程式碼範例是本類別更大範例 HideDisabledControlAdapter 的一部分。

protected override void Render(System.Web.UI.HtmlTextWriter writer)
{
    if (Control.ID.StartsWith("Contoso"))
    {
        if (!Control.Enabled)
        {
            return;
        }
    }

    base.Render(writer);
}
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
    If (Control.ID.StartsWith("Contoso")) Then
        If (Not Control.Enabled) Then
            Return
        End If
    End If

    MyBase.Render(writer)
End Sub

備註

此 Render 方法會將相關的 WebControl 控制項寫入輸出串流,格式為 HTML。

預設情況下,.NET Framework 會呼叫網頁伺服器控制項本身 Render 的方法。 然而,一旦 Adapter 該控制項的屬性設定完成,.NET Framework 會執行介面卡對事件的實作,而非相關控制項的實作 Render 。

此 Render 事件用於修改渲染到裝置瀏覽器的標記程式碼。 控制屬性應該在此生命週期的這個階段之前設定,且僅在實際的標記建立時才完成。 生命週期此階段對控制項所做的變更不會被儲存為檢視狀態。 若要儲存對控制項所做的變更,請覆寫事件。OnPreRender

事件 Render 也允許衍生類別處理事件而無需附加代理,這是處理衍生類別事件的首選技術。

適用於

另請參閱