WebControl.AddAttributesToRender(HtmlTextWriter) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriterTag 中。 這個方法主要由控制項開發人員使用。

protected:
 virtual void AddAttributesToRender(System::Web::UI::HtmlTextWriter ^ writer);

protected virtual void AddAttributesToRender (System.Web.UI.HtmlTextWriter writer);

abstract member AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit
override this.AddAttributesToRender : System.Web.UI.HtmlTextWriter -> unit

Protected Overridable Sub AddAttributesToRender (writer As HtmlTextWriter)

參數

writer

HtmlTextWriter

HtmlTextWriter，代表要於用戶端呈現 HTML 內容的輸出資料流。

範例

下列範例示範如何建立衍生自 類別的 WebControl 類別。 系統會覆寫 方法的基底實作 AddAttributesToRender ，以將適合輸出數據流中 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 伺服器控制件的屬性和樣式，您通常會呼叫 AddAttribute 和 HtmlTextWriter.AddStyleAttribute 方法，將 HtmlTextWriter 每個屬性和樣式個別插入輸出數據流。 為了簡化此程式，這個方法會封裝與 Web 伺服器控件相關聯之每個屬性和樣式之 和 HtmlTextWriter.AddStyleAttribute 方法的所有呼叫HtmlTextWriter.AddAttribute。 所有屬性和樣式都會在單一方法呼叫中插入 HtmlTextWriter 輸出數據流。 這個方法通常是由衍生類別中的控件開發人員覆寫，以將適當的屬性和樣式 HtmlTextWriter 插入類別的輸出數據流。

注意

AddAttributesToRender方法無法用來插入用戶端文本。 若要使用用戶端文本，請參閱 類別 ClientScriptManager 。

另請參閱

• AddAttribute
• AddStyleAttribute
• HtmlTextWriter
• 開發自訂 ASP.NET 伺服器控制件