WebControlAdapter.RenderContents(HtmlTextWriter) 方法

定义

为附加了控件适配器的 Web 控件生成特定于目标的内部标记内容。Generates the target-specific inner markup for the Web control to which the control adapter is attached.

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

包含可呈现特定于目标的输出的方法的 HtmlTextWriterThe HtmlTextWriter containing methods to render the target-specific output.

注解

RenderContents方法在控件的开始标记和结束标记之间生成内部标记。The RenderContents method generates the inner markup, between the beginning and ending tags for the control. 通常,标记由生成 Render ,后者按以下顺序调用方法:Typically, markup is generated by Render, which calls methods in the following order:

  1. RenderBeginTag.RenderBeginTag.

  2. RenderContents.RenderContents.

  3. RenderEndTag.RenderEndTag.

重写 RenderContents 以生成要发送到客户端浏览器的目标特定内部标记。Override RenderContents to generate target-specific inner markup to send to the client browser.

RenderContents基方法调用 WebControl.RenderContentsThe RenderContents base method calls WebControl.RenderContents. WebControl.RenderContents基方法调用 Control.Render ,后者又调用 Control.RenderChildrenThe WebControl.RenderContents base method calls Control.Render, which in turn calls Control.RenderChildren. 因此,的重写 RenderContents 仅应 RenderContents 在其处理不是而不是的情况下调用基方法 Control.RenderThus, overrides of RenderContents should call the RenderContents base method only if its processing is in addition to, rather than instead of, Control.Render.

继承者说明

对于复合控件,必须确保呈现子控件。For a composite control, you must ensure that the child controls are rendered. 如果重写 RenderContents(HtmlTextWriter) 方法并且不调用其基方法,则可以通过调用( RenderChildren(HtmlTextWriter) 如果未重写) RenderChildren(HtmlTextWriter) 从重写调用来呈现子控件 RenderContents(HtmlTextWriter)If you override the RenderContents(HtmlTextWriter) method and do not call its base method, you can cause the child controls to be rendered by calling RenderChildren(HtmlTextWriter) which, if not overridden, calls RenderChildren(HtmlTextWriter) from the RenderContents(HtmlTextWriter) override.

适用于

另请参阅