HtmlTextWriter.AddStyleAttribute HtmlTextWriter.AddStyleAttribute HtmlTextWriter.AddStyleAttribute HtmlTextWriter.AddStyleAttribute Method

定義

HtmlTextWriter オブジェクトが後続の RenderBeginTag メソッドの呼び出しで作成する要素の開始タグに、マークアップ スタイル属性を追加します。Adds a markup style attribute to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

オーバーロード

AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始タグに、指定されたマークアップ スタイル属性および属性値を追加します。Adds the specified markup style attribute and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、指定された HtmlTextWriterStyle 値および属性値に関連付けられたマークアップ スタイル属性を追加します。Adds the markup style attribute associated with the specified HtmlTextWriterStyle value and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、HtmlTextWriterStyle 列挙値と共に、指定されたマークアップ スタイル属性および属性値を追加します。Adds the specified markup style attribute and the attribute value, along with an HtmlTextWriterStyle enumeration value, to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String) AddStyleAttribute(String, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始タグに、指定されたマークアップ スタイル属性および属性値を追加します。Adds the specified markup style attribute and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

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

追加するスタイル属性を格納している文字列。A string that contains the style attribute to add.

value
String String String String

属性に割り当てる値を格納している文字列。A string that contains the value to assign to the attribute.

次のコード例を使用する方法を示しています、RenderBeginTagのオーバー ロード、AddStyleAttribute(String, String)メソッドfont-sizecolorにスタイル属性を<p>要素。The following code example shows how to use the RenderBeginTag overload of the AddStyleAttribute(String, String) method to render font-size and color style attributes on a <p> element. このコード例では、HtmlTextWriterコントロールの内容を表示するクラス。This code example uses the HtmlTextWriter class to render the contents of the control.

// 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列挙型か、実行時まで不明します。Use the AddStyleAttribute overload of the AddStyleAttribute(String, String) method when the style is not a member of the HtmlTextWriterStyle enumeration or is not known until run time.

HtmlTextWriterクラスが表示されるマークアップ要素のスタイルのリストを保持します。The HtmlTextWriter class maintains a list of styles for the markup elements it renders. ときに、RenderBeginTagメソッドが呼び出されると、によって追加された任意のスタイル、AddStyleAttributeメソッドは、要素の開始タグに表示されます。When the RenderBeginTag method is called, any styles that are added by the AddStyleAttribute method are rendered to the opening tag of the element. スタイルの一覧は、クリアされます。The list of styles is then cleared.

マークアップ要素をレンダリングするためのコーディング パターンは次のとおりです。The coding pattern for rendering markup elements is as follows:

  • 使用して、AddStyleAttribute要素に属性を任意のスタイルを追加します。Use the AddStyleAttribute method to add any style attributes to the element.

  • RenderBeginTag メソッドを使用します。Use the RenderBeginTag method.

  • 要素の開始と終了タグの間にあるコンテンツを表示するために必要に応じてその他のメソッドを使用します。Use other methods as needed to render the content found between the element opening and closing tags.

  • RenderEndTag メソッドを使用します。Use the RenderEndTag method.

こちらもご覧ください

AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String) AddStyleAttribute(HtmlTextWriterStyle, String)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、指定された HtmlTextWriterStyle 値および属性値に関連付けられたマークアップ スタイル属性を追加します。Adds the markup style attribute associated with the specified HtmlTextWriterStyle value and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

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

出力ストリームに追加するスタイル属性を表す HtmlTextWriterStyleAn HtmlTextWriterStyle that represents the style attribute to add to the output stream.

value
String String String String

属性に割り当てる値を格納している文字列。A string that contains the value to assign to the attribute.

次のコード例は、のオーバーライドの一部を使用する方法を示します、RenderBeginTagから派生したクラスのメソッド、HtmlTextWriterクラス。The following code example demonstrates how to use part of an override of the RenderBeginTag method in a class derived from the HtmlTextWriter class. コードのチェックするかどうかを<Label>レンダリングされる要素。The code checks whether a <Label> element is being rendered. そうである場合、IsStyleAttributeDefinedを確認するメソッドが呼び出されるかどうかをColorスタイル属性が定義されている、<Label>要素。If so, the IsStyleAttributeDefined method is called to check whether a Color style attribute has been defined for the <Label> element. 場合、Color属性が定義されていない、コードのこのオーバー ロードを呼び出して、AddStyleAttributeを追加するメソッド、Colorスタイル属性に属性し、その値を設定し、redします。If a Color attribute has not been defined, the code calls this overload of the AddStyleAttribute method to add the Color attribute to the style attribute, and then set its value to 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列挙され、実行する前に呼ばれます。Use the AddStyleAttribute overload of the AddStyleAttribute(HtmlTextWriterStyle, String) method when the style is a member of the HtmlTextWriterStyle enumeration and is known before run time.

HtmlTextWriterクラスが表示されるマークアップ要素のスタイルのリストを保持します。The HtmlTextWriter class maintains a list of styles for the markup elements it renders. ときに、RenderBeginTagメソッドが呼び出されると、によって追加された任意のスタイル、AddStyleAttributeメソッドは、要素の開始タグに表示されます。When the RenderBeginTag method is called, any styles added by the AddStyleAttribute method are rendered to the opening tag of the element. スタイルの一覧は、クリアされます。The list of styles is then cleared.

マークアップ要素をレンダリングするためのコーディング パターンは次のとおりです。The coding pattern for rendering markup elements is as follows:

  • 使用して、AddStyleAttribute要素に属性を任意のスタイルを追加します。Use the AddStyleAttribute method to add any style attributes to the element.

  • RenderBeginTag メソッドを使用します。Use the RenderBeginTag method.

  • 要素の開始と終了タグの間にあるコンテンツを表示するために必要に応じてその他のメソッドを使用します。Use other methods as needed to render the content found between the element opening and closing tags.

  • RenderEndTag メソッドを使用します。Use the RenderEndTag method.

こちらもご覧ください

AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle) AddStyleAttribute(String, String, HtmlTextWriterStyle)

後続の RenderBeginTag メソッドの呼び出しで作成される開始マークアップ タグに、HtmlTextWriterStyle 列挙値と共に、指定されたマークアップ スタイル属性および属性値を追加します。Adds the specified markup style attribute and the attribute value, along with an HtmlTextWriterStyle enumeration value, to the opening markup tag created by a subsequent call to the RenderBeginTag method.

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

追加されるスタイル属性を格納している文字列。A string that contains the style attribute to be added.

value
String String String String

属性に割り当てる値を格納している文字列。A string that contains the value to assign to the attribute.

key
HtmlTextWriterStyle HtmlTextWriterStyle HtmlTextWriterStyle HtmlTextWriterStyle

追加するスタイル属性を表す HtmlTextWriterStyleAn HtmlTextWriterStyle that represents the style attribute to add.

注釈

使用して、AddStyleAttributeのオーバー ロード、AddStyleAttribute(String, String, HtmlTextWriterStyle)メソッドから継承する場合にのみ、HtmlTextWriterクラス。Use the AddStyleAttribute overload of the AddStyleAttribute(String, String, HtmlTextWriterStyle) method only when inheriting from the HtmlTextWriter class. 新規作成することもできるnamevalueのペアをHtmlTextWriterStyle属性。It enables you to create new name and value pairs for HtmlTextWriterStyle attributes.

こちらもご覧ください

適用対象