WebControlAdapter.RenderContents(HtmlTextWriter) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
為附加控制項配置器的 Web 控制項產生特定目標內部標記。
protected:
virtual void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void RenderContents (System.Web.UI.HtmlTextWriter writer);
abstract member RenderContents : System.Web.UI.HtmlTextWriter -> unit
override this.RenderContents : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub RenderContents (writer As HtmlTextWriter)
參數
- writer
- HtmlTextWriter
包含呈現特定目標輸出方法的 HtmlTextWriter。
備註
方法會在 RenderContents 控制項的開頭和結束記號之間產生內部標記。 通常會由產生標記 Render ,而這會依下列順序呼叫方法:
覆寫 RenderContents 以產生要傳送至用戶端瀏覽器的目標特定內部標記。
RenderContents基底方法呼叫 WebControl.RenderContents 。 WebControl.RenderContents基底方法會呼叫 Control.Render ,然後再呼叫 Control.RenderChildren 。 因此,的覆寫 RenderContents 只應呼叫 RenderContents 基底方法(如果它的處理是,而不是) Control.Render 。
給繼承者的注意事項
若為複合控制項,您必須確定子控制項已呈現。 如果您覆寫 RenderContents(HtmlTextWriter) 方法,但未呼叫其基底方法,您可以藉由呼叫覆寫中的 RenderChildren(HtmlTextWriter) 呼叫(若不覆寫)來呈現子控制項 RenderChildren(HtmlTextWriter) RenderContents(HtmlTextWriter) 。