HideDisabledControlAdapter.Render(HtmlTextWriter) 方法

定義

命名空間:

System.Web.UI.WebControls.Adapters

組件:

System.Web.dll

將關聯的 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在 Web 服務器控制項自己的 Render 方法上呼叫 。 不過，一旦 Adapter 設定該控制項的 屬性，.NET Framework就會在相關聯的控制項上執行事件的配接器實作 Render 。

事件 Render 可用來對轉譯至裝置瀏覽器的標記程式碼執行修改。 控制項屬性應該在生命週期的這個階段之前設定，而且只針對此處完成的控制項建立實際標記。 生命週期這個階段中控制項所做的變更不會儲存至檢視狀態。 若要儲存對 控制項所做的變更，請覆寫 OnPreRender 事件。

事件 Render 也允許衍生類別處理事件，而不附加委派，這是在衍生類別中處理事件的慣用技巧。

另請參閱

• WebControl
• Control
• WebControlAdapter
• OnPreRender(EventArgs)