Control.Render(HtmlTextWriter) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將伺服器控制項內容傳送到提供的 HtmlTextWriter 物件，以寫入要在用戶端上呈現的內容。

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

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

protected 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 Overridable Sub Render (writer As HtmlTextWriter)

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 網頁生命週期簡介