HideDisabledControlAdapter.Render(HtmlTextWriter) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將相關的 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 也允許衍生類別處理事件而無需附加代理,這是處理衍生類別事件的首選技術。