Control.Render(HtmlTextWriter) 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將伺服器控制項內容傳送到提供的 HtmlTextWriter 物件，以寫入要在用戶端上呈現的內容。
protected:
virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);protected public:
virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);C#
protected virtual void Render(System.Web.UI.HtmlTextWriter writer);C#
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 -> unitProtected 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 字串。
C#
[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 頁面的內容。
| 產品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
