語言

Style.AddAttributesToRender 方法

定義

新增需要渲染的 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 。

另請參閱

適用於