WebControl.AddAttributesToRender(HtmlTextWriter) WebControl.AddAttributesToRender(HtmlTextWriter) WebControl.AddAttributesToRender(HtmlTextWriter) WebControl.AddAttributesToRender(HtmlTextWriter) Method

定義

指定した HtmlTextWriterTag に表示する必要のある HTML 属性およびスタイルを追加します。Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. このメソッドは、主にコントロールの開発者によって使用されます。This method is used primarily by control developers.

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 HtmlTextWriter HtmlTextWriter

HTML コンテンツをクライアントに表示する出力ストリームを表す HtmlTextWriterA HtmlTextWriter that represents the output stream to render HTML content on the client.

WebControlクラスから派生するクラスを作成する方法を次の例に示します。The following example demonstrates how to create a class that derives from the WebControl class. AddAttributesToRenderメソッドの基本実装は、 HtmlTextWriter出力ストリームの派生クラスに適切な属性を追加するためにオーバーライドされます。The base implementation of the AddAttributesToRender method is overridden to add attributes appropriate to the derived class in the HtmlTextWriter output stream.

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とスタイルを出力ストリームに個別に挿入します。To render attributes and styles for a Web Server control on the client, you typically call the AddAttribute and HtmlTextWriter.AddStyleAttribute methods to insert each attribute and style individually to the HtmlTextWriter output stream. プロセスを簡略化するために、このメソッドは、Web HtmlTextWriter.AddAttributeサーバー HtmlTextWriter.AddStyleAttributeコントロールに関連付けられているすべての属性とスタイルについて、メソッドおよびメソッドへのすべての呼び出しをカプセル化します。To simplify the process, this method encapsulates all calls to the HtmlTextWriter.AddAttribute and HtmlTextWriter.AddStyleAttribute methods for every attribute and style associated with the Web server control. すべての属性とスタイルは、1 HtmlTextWriter回のメソッド呼び出しで出力ストリームに挿入されます。All attributes and styles are inserted into the HtmlTextWriter output stream in a single method call. 通常、このメソッドは、派生クラスのコントロール開発者によってオーバーライドされ、クラスHtmlTextWriterの出力ストリームに適切な属性とスタイルを挿入します。This method is typically overridden by control developers in derived classes to insert the appropriate attributes and styles to the HtmlTextWriter output stream for the class.

注意

メソッドAddAttributesToRenderを使用してクライアントスクリプトを挿入することはできません。The AddAttributesToRender method cannot be used to insert client script. クライアントスクリプトを使用するにはClientScriptManager 、クラスを参照してください。To use client script, see the ClientScriptManager class.

適用対象

こちらもご覧ください