Style.AddAttributesToRender 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
新增需要渲染的 HTML 屬性與樣式。HtmlTextWriter 此方法主要由控制開發者使用。
多載
| 名稱 | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
新增需要渲染的 HTML 屬性與樣式。HtmlTextWriter 此方法主要由控制開發者使用。 |
| AddAttributesToRender(HtmlTextWriter, WebControl) |
新增需要渲染的 HTML 屬性與樣式,並用於指定 HtmlTextWriter 及網頁伺服器控制項。 此方法主要由控制開發者使用。 |
AddAttributesToRender(HtmlTextWriter)
新增需要渲染的 HTML 屬性與樣式。HtmlTextWriter 此方法主要由控制開發者使用。
public:
void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);
public void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer);
member this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
Public Sub AddAttributesToRender (writer As HtmlTextWriter)
參數
- writer
- HtmlTextWriter
A HtmlTextWriter 代表輸出串流,用來在用戶端渲染 HTML 內容。
備註
要在用戶端渲染網頁伺服器控制項的屬性和樣式,通常會呼叫 and HtmlTextWriter.AddAttributeHtmlTextWriter.AddStyleAttribute 方法,將每個屬性和樣式分別插入輸出串流。System.Web.UI.HtmlTextWriter 為了簡化流程,此方法封裝了所有與 HtmlTextWriter.AddAttributeHtmlTextWriter.AddStyleAttribute and 方法相關的呼叫,涵蓋與 Web 伺服器控制項相關的每個屬性與樣式。 所有屬性與樣式會在單一方法呼叫中插入 System.Web.UI.HtmlTextWriter 輸出串流中。
另請參閱
適用於
AddAttributesToRender(HtmlTextWriter, WebControl)
新增需要渲染的 HTML 屬性與樣式,並用於指定 HtmlTextWriter 及網頁伺服器控制項。 此方法主要由控制開發者使用。
public:
virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::WebControls::WebControl ^ owner);
public virtual void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer, System.Web.UI.WebControls.WebControl owner);
abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebControl -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebControl -> unit
Public Overridable Sub AddAttributesToRender (writer As HtmlTextWriter, owner As WebControl)
參數
- writer
- HtmlTextWriter
一個 HtmlTextWriter 代表輸出串流,用來在客戶端渲染 HTML 內容。
- owner
- WebControl
一個WebControlWebControl或衍生物件,代表與 Style相關聯的網頁伺服器控制。
範例
以下範例示範如何建立由該 WebControl 類別衍生的類別。 方法的基礎實作 AddAttributesToRender 會被覆寫,以在輸出串流中加入適合導出類別 System.Web.UI.HtmlTextWriter 的屬性。
namespace ControlTest
{
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
// Renders the following HTML:
// <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
public class MyWebControl: WebControl {
public MyWebControl() : base(HtmlTextWriterTag.Span)
{ }
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void AddAttributesToRender(HtmlTextWriter writer)
{
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
base.AddAttributesToRender(writer);
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void RenderContents(HtmlTextWriter writer)
{
writer.Write("Custom Contents");
base.RenderContents(writer);
}
}
}
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace ControlTest
' Renders the following HTML:
' <span onclick="alert('Hello');" style="color:Red;">Custom Contents</span>
Public Class MyWebControl
Inherits WebControl
Public Sub New()
MyBase.New(HtmlTextWriterTag.Span)
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub AddAttributesToRender(writer As HtmlTextWriter)
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
MyBase.AddAttributesToRender(writer)
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub RenderContents(writer As HtmlTextWriter)
writer.Write("Custom Contents")
MyBase.RenderContents(writer)
End Sub
End Class
End Namespace 'ControlTest
備註
要在用戶端渲染網頁伺服器控制項的屬性和樣式,通常會呼叫 and HtmlTextWriter.AddAttributeHtmlTextWriter.AddStyleAttribute 方法,將每個屬性和樣式分別插入輸出串流。System.Web.UI.HtmlTextWriter 為了簡化流程,此方法封裝了所有與 HtmlTextWriter.AddAttributeHtmlTextWriter.AddStyleAttribute and 方法相關的呼叫,涵蓋與 Web Server 控制項相關的每個屬性與樣式。 所有屬性與樣式會在單一方法呼叫中插入 System.Web.UI.HtmlTextWriter 輸出串流中。 此方法通常會被派生類別中的控制開發者覆寫,以在該類別的輸出串流中插入適當的屬性與樣式 System.Web.UI.HtmlTextWriter 。