Style.AddAttributesToRender 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 中。 這個方法主要由控制項開發人員使用。
多載
AddAttributesToRender(HtmlTextWriter) |
將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 中。 這個方法主要由控制項開發人員使用。 |
AddAttributesToRender(HtmlTextWriter, WebControl) |
將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 和 Web 伺服器控制項中。 這個方法主要由控制項開發人員使用。 |
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
HtmlTextWriter,代表要於用戶端呈現 HTML 內容的輸出資料流。
備註
若要在用戶端上轉譯 Web 服務器控制項的屬性和樣式,您通常會呼叫 HtmlTextWriter.AddAttribute 和 HtmlTextWriter.AddStyleAttribute 方法,將每個屬性和樣式個別 System.Web.UI.HtmlTextWriter 插入輸出資料流程。 為了簡化此程式,這個方法會封裝與 Web 服務器控制項相關聯之每個屬性和樣式之 和 HtmlTextWriter.AddStyleAttribute 方法的所有呼叫 HtmlTextWriter.AddAttribute 。 所有屬性和樣式都會在單一方法呼叫中插入 System.Web.UI.HtmlTextWriter 輸出資料流程。
另請參閱
適用於
AddAttributesToRender(HtmlTextWriter, WebControl)
將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 和 Web 伺服器控制項中。 這個方法主要由控制項開發人員使用。
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
WebControl 或 WebControl 衍生物件,表示與 Style 關聯的 Web 伺服器控制項。
範例
下列範例示範如何建立衍生自 類別的 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
備註
若要在用戶端上轉譯 Web 服務器控制項的屬性和樣式,您通常會呼叫 HtmlTextWriter.AddAttribute 和 HtmlTextWriter.AddStyleAttribute 方法,將每個屬性和樣式個別 System.Web.UI.HtmlTextWriter 插入輸出資料流程。 為了簡化程式,這個方法會封裝與網頁伺服器控制項相關聯之每個屬性和樣式之 和 HtmlTextWriter.AddStyleAttribute 方法的所有呼叫 HtmlTextWriter.AddAttribute 。 所有屬性和樣式都會在單一方法呼叫中插入 System.Web.UI.HtmlTextWriter 輸出資料流程。 這個方法通常是由衍生類別中的控制項開發人員覆寫,以將適當的屬性和樣式 System.Web.UI.HtmlTextWriter 插入類別的輸出資料流程。