Style.AddAttributesToRender メソッド

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

指定した HtmlTextWriter に表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。

オーバーロード

AddAttributesToRender(HtmlTextWriter)	指定した HtmlTextWriter に表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。
AddAttributesToRender(HtmlTextWriter, WebControl)	指定した HtmlTextWriter と Web サーバー コントロールに、表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。

AddAttributesToRender(HtmlTextWriter)

指定した HtmlTextWriter に表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。

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

HTML コンテンツをクライアントに表示する出力ストリームを表す HtmlTextWriter。

注釈

クライアントで Web サーバー コントロールの属性とスタイルをレンダリングするには、通常、出力ストリームに各属性とスタイルを個別に挿入するメソッドとHtmlTextWriter.AddStyleAttributeメソッドをSystem.Web.UI.HtmlTextWriter呼び出HtmlTextWriter.AddAttributeします。 このプロセスを簡略化するために、このメソッドは、Web サーバー コントロールに HtmlTextWriter.AddAttribute 関連付けられているすべての属性と HtmlTextWriter.AddStyleAttribute スタイルに対するすべての呼び出しとメソッドをカプセル化します。 すべての属性とスタイルは、1 回の System.Web.UI.HtmlTextWriter メソッド呼び出しで出力ストリームに挿入されます。

こちらもご覧ください

• AddAttribute(String, String)
• AddStyleAttribute(String, String)
• HtmlTextWriter

AddAttributesToRender(HtmlTextWriter, WebControl)

指定した HtmlTextWriter と Web サーバー コントロールに、表示する必要のある HTML 属性およびスタイルを追加します。 このメソッドは、主にコントロールの開発者によって使用されます。

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

クライアントに HTML コンテンツを表示する出力ストリームを表す HtmlTextWriter。

owner

WebControl

WebControl に関連付けられた Web サーバー コントロールを表す WebControl または 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

注釈

クライアントで Web サーバー コントロールの属性とスタイルをレンダリングするには、通常、出力ストリームに各属性とスタイルを個別に挿入するメソッドとHtmlTextWriter.AddStyleAttributeメソッドをSystem.Web.UI.HtmlTextWriter呼び出HtmlTextWriter.AddAttributeします。 このプロセスを簡略化するために、このメソッドは、Web Server コントロールに HtmlTextWriter.AddAttribute 関連付けられているすべての属性と HtmlTextWriter.AddStyleAttribute スタイルに対するすべての呼び出しとメソッドの呼び出しをカプセル化します。 すべての属性とスタイルは、1 回の System.Web.UI.HtmlTextWriter メソッド呼び出しで出力ストリームに挿入されます。 通常、このメソッドは派生クラスのコントロール開発者によってオーバーライドされ、クラスの出力ストリームに System.Web.UI.HtmlTextWriter 適切な属性とスタイルを挿入します。

こちらもご覧ください

• AddAttribute(String, String)
• AddStyleAttribute(String, String)
• HtmlTextWriter