Style.AddAttributesToRender メソッド

定義

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

こちらもご覧ください

適用対象