HtmlTextWriter.AddStyleAttribute メソッド

リファレンス

定義

名前空間:: System.Web.UI

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 作成できます。

こちらもご覧ください

適用対象

次の方法で共有

HtmlTextWriter.AddStyleAttribute メソッド

定義

オーバーロード

AddStyleAttribute(String, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

AddStyleAttribute(HtmlTextWriterStyle, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

AddStyleAttribute(String, String, HtmlTextWriterStyle)

パラメーター

注釈

こちらもご覧ください

適用対象

その他のリソース