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 頁面生命周期簡介