HtmlTextWriter.AddStyleAttribute メソッド

定義

HtmlTextWriter オブジェクトが後続の RenderBeginTag メソッドの呼び出しで作成する要素の開始タグに、マークアップ スタイル属性を追加します。

オーバーロード

AddStyleAttribute(String, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始タグに、指定されたマークアップ スタイル属性および属性値を追加します。

AddStyleAttribute(HtmlTextWriterStyle, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、指定された HtmlTextWriterStyle 値および属性値に関連付けられたマークアップ スタイル属性を追加します。

AddStyleAttribute(String, String, HtmlTextWriterStyle)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、HtmlTextWriterStyle 列挙値と共に、指定されたマークアップ スタイル属性および属性値を追加します。

AddStyleAttribute(String, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始タグに、指定されたマークアップ スタイル属性および属性値を追加します。

public:
 virtual void AddStyleAttribute(System::String ^ name, System::String ^ value);
public virtual void AddStyleAttribute (string name, string value);
abstract member AddStyleAttribute : string * string -> unit
override this.AddStyleAttribute : string * string -> unit
Public Overridable Sub AddStyleAttribute (name As String, value As String)

パラメーター

name
String

追加するスタイル属性を格納している文字列。

value
String

属性に割り当てる値を格納している文字列。

次のコード例は、 メソッドのオーバーロードを RenderBeginTag 使用して、 AddStyleAttribute(String, String) 要素に属性をレンダリング font-size し、 color スタイルを設定する方法を <p> 示しています。 このコード例では、 クラスを HtmlTextWriter 使用してコントロールの内容をレンダリングします。

// Add style attribute for 'p'(paragraph) element.
writer->AddStyleAttribute( "font-size", "12pt" );
writer->AddStyleAttribute( "color", "fuchsia" );
// Output the 'p' (paragraph) element with the style attributes.
writer->RenderBeginTag( "p" );
// Output the 'Message' property contents and the time on the server.
writer->Write( String::Concat( Message, "<br>",
   "The time on the server: ",
   System::DateTime::Now.ToLongTimeString() ) );

// Close the element.
writer->RenderEndTag();
// Add style attribute for 'p'(paragraph) element.
writer.AddStyleAttribute("font-size", "12pt");
writer.AddStyleAttribute("color", "fuchsia");
// Output the 'p' (paragraph) element with the style attributes.
writer.RenderBeginTag("p");
// Output the 'Message' property contents and the time on the server.
writer.Write(Message + "<br>" +
    "The time on the server: " +
    System.DateTime.Now.ToLongTimeString());

// Close the element.
writer.RenderEndTag();
'Add style attribute for 'p'(paragraph) element.
writer.AddStyleAttribute("font-size", "12pt")
writer.AddStyleAttribute("color", "fuchsia")

'Output the 'p' (paragraph) element with the style attributes.
writer.RenderBeginTag("p")

'Output the 'Message' property contents and the time on the server.
writer.Write((Message & "<br>" & "The time on the server: " & _
   System.DateTime.Now.ToLongTimeString()))

' Close the element.
writer.RenderEndTag()

注釈

スタイルが AddStyleAttribute 列挙体の AddStyleAttribute(String, String) メンバーではない場合、または実行時まで不明な場合は、 メソッドの HtmlTextWriterStyle オーバーロードを使用します。

クラスは HtmlTextWriter 、レンダリングするマークアップ要素のスタイルの一覧を保持します。 メソッドが RenderBeginTag 呼び出されると、 メソッドによって AddStyleAttribute 追加されたすべてのスタイルが、 要素の開始タグにレンダリングされます。 その後、スタイルの一覧がクリアされます。

マークアップ要素をレンダリングするためのコーディング パターンは次のとおりです。

  • メソッドを AddStyleAttribute 使用して、要素にスタイル属性を追加します。

  • RenderBeginTag メソッドを使用します。

  • 必要に応じて他のメソッドを使用して、要素の開始タグと終了タグの間にあるコンテンツをレンダリングします。

  • RenderEndTag メソッドを使用します。

こちらもご覧ください

適用対象

AddStyleAttribute(HtmlTextWriterStyle, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、指定された HtmlTextWriterStyle 値および属性値に関連付けられたマークアップ スタイル属性を追加します。

public:
 virtual void AddStyleAttribute(System::Web::UI::HtmlTextWriterStyle key, System::String ^ value);
public virtual void AddStyleAttribute (System.Web.UI.HtmlTextWriterStyle key, string value);
abstract member AddStyleAttribute : System.Web.UI.HtmlTextWriterStyle * string -> unit
override this.AddStyleAttribute : System.Web.UI.HtmlTextWriterStyle * string -> unit
Public Overridable Sub AddStyleAttribute (key As HtmlTextWriterStyle, value As String)

パラメーター

key
HtmlTextWriterStyle

出力ストリームに追加するスタイル属性を表す HtmlTextWriterStyle

value
String

属性に割り当てる値を格納している文字列。

次のコード例では、 クラスから派生したクラスで メソッドのオーバーライドの RenderBeginTag 一部を使用する方法を HtmlTextWriter 示します。 コードは、要素が <Label> レンダリングされているかどうかを確認します。 その場合は、 IsStyleAttributeDefined メソッドが呼び出され、 要素に Color<Label> してスタイル属性が定義されているかどうかを確認します。 属性が Color 定義されていない場合、コードは メソッドのこのオーバーロードを AddStyleAttribute 呼び出して属性を Color style 属性に追加し、その値を に red設定します。

// If the markup element being rendered is a Label,
// render the opening tag of a <Font> element before it.
if ( tagKey == HtmlTextWriterTag::Label )
{
   
   // Check whether a Color style attribute is
   // included on the Label. If not, use the
   // AddStyleAttribute and GetStyleName methods to add one
   // and set its value to red.
   if (  !IsStyleAttributeDefined( HtmlTextWriterStyle::Color ) )
   {
      AddStyleAttribute( GetStyleName( HtmlTextWriterStyle::Color ), "red" );
   }
// If the markup element being rendered is a Label,
// render the opening tag of a Font element before it.
if (tagKey == HtmlTextWriterTag.Label)
{
    // Check whether a Color style attribute is 
    // included on the Label. If not, use the
    // AddStyleAttribute and GetStyleName methods to add one
    // and set its value to red.
    if (!IsStyleAttributeDefined(HtmlTextWriterStyle.Color))
    {
        AddStyleAttribute(GetStyleName(HtmlTextWriterStyle.Color), "red");
    }
' If the markup element being rendered is a Label,
' render the opening tag of a Font element before it.
If tagKey = HtmlTextWriterTag.Label Then
    ' Check whether a Color style attribute is 
    ' included on the Label. If not, use the
    ' AddStyleAttribute and GetStyleName methods to add one
    ' and set its value to red.
    If Not IsStyleAttributeDefined(HtmlTextWriterStyle.Color) Then
        AddStyleAttribute(GetStyleName(HtmlTextWriterStyle.Color), "red")
    End If

注釈

スタイルが AddStyleAttribute 列挙体の AddStyleAttribute(HtmlTextWriterStyle, String) メンバーであり、実行時より前にわかっているときは、 メソッドの HtmlTextWriterStyle オーバーロードを使用します。

クラスは HtmlTextWriter 、レンダリングするマークアップ要素のスタイルの一覧を保持します。 メソッドが RenderBeginTag 呼び出されると、メソッドによって AddStyleAttribute 追加されたすべてのスタイルが 要素の開始タグにレンダリングされます。 その後、スタイルの一覧がクリアされます。

マークアップ要素をレンダリングするためのコーディング パターンは次のとおりです。

  • メソッドを AddStyleAttribute 使用して、要素にスタイル属性を追加します。

  • RenderBeginTag メソッドを使用します。

  • 必要に応じて他のメソッドを使用して、要素の開始タグと終了タグの間にあるコンテンツをレンダリングします。

  • RenderEndTag メソッドを使用します。

こちらもご覧ください

適用対象

AddStyleAttribute(String, String, HtmlTextWriterStyle)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、HtmlTextWriterStyle 列挙値と共に、指定されたマークアップ スタイル属性および属性値を追加します。

protected:
 virtual void AddStyleAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterStyle key);
protected virtual void AddStyleAttribute (string name, string value, System.Web.UI.HtmlTextWriterStyle key);
abstract member AddStyleAttribute : string * string * System.Web.UI.HtmlTextWriterStyle -> unit
override this.AddStyleAttribute : string * string * System.Web.UI.HtmlTextWriterStyle -> unit
Protected Overridable Sub AddStyleAttribute (name As String, value As String, key As HtmlTextWriterStyle)

パラメーター

name
String

追加されるスタイル属性を格納している文字列。

value
String

属性に割り当てる値を格納している文字列。

key
HtmlTextWriterStyle

追加するスタイル属性を表す HtmlTextWriterStyle

注釈

AddStyleAttributeクラスから継承する場合にのみ、 AddStyleAttribute(String, String, HtmlTextWriterStyle) メソッドのオーバーロードをHtmlTextWriter使用します。 これにより、属性の新しい name ペアと value ペアを HtmlTextWriterStyle 作成できます。

こちらもご覧ください

適用対象