Control.Render(HtmlTextWriter) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

将服务器控件内容发送到给定的 HtmlTextWriter 对象，该对象可编写将在客户端呈现的内容。

protected public:
 virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);

protected internal virtual void Render (System.Web.UI.HtmlTextWriter writer);

abstract member Render : System.Web.UI.HtmlTextWriter -> unit
override this.Render : System.Web.UI.HtmlTextWriter -> unit

Protected Friend Overridable Sub Render (writer As HtmlTextWriter)

参数

writer

HtmlTextWriter

用于接收服务器控件内容的 HtmlTextWriter 对象。

示例

下面的代码示例演示如何重写 Render 方法。 HasControls方法用于确定服务器控件是否具有存储在其 ControlCollection 对象中的任何子控件，该对象可通过 Control.Controls 属性进行访问。 如果 HasControls 返回 true，并且集合中的第一个服务器控件是文本文本，则文本文本将追加到 HTML 字符串。

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render(HtmlTextWriter output) {
    if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
        output.Write("<H2>Your Message: " + ((LiteralControl) Controls[0]).Text + "</H2>");
    }
}

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
    If HasControls() And TypeOf Controls(0) Is LiteralControl
        Dim Ctrl As LiteralControl = CType(Controls(0), LiteralControl)
        Output.Write("<H2>Your Message: " & Ctrl.Text & "</H2>")
    End If
End Sub

注解

开发自定义服务器控件时，可以重写此方法以生成 ASP.NET 页面的内容。

另请参阅

• HtmlTextWriter
• ASP.NET 页面生命周期简介