Control.Render(HtmlTextWriter) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將伺服器控制內容傳送給所提供的 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 頁面生成內容。