HtmlTextWriter.AddStyleAttribute 方法

定义

将标记样式属性添加到 HtmlTextWriter 对象创建的元素的开始标记,随后调用 RenderBeginTag 方法。

重载

AddStyleAttribute(String, String)

对于通过对 RenderBeginTag 方法的后续调用创建的开始标记,向其中添加指定的标记样式属性和属性值。

AddStyleAttribute(HtmlTextWriterStyle, String)

对于通过对 HtmlTextWriterStyle 方法的后续调用而创建的开始标记,向其中添加与指定的 RenderBeginTag 值相关联的标记样式属性和属性值。

AddStyleAttribute(String, String, HtmlTextWriterStyle)

对于通过对 HtmlTextWriterStyle 方法的后续调用而创建的开始标记,向其中添加指定的标记样式属和属性值以及 RenderBeginTag 枚举值。

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)重载在元素上<p>呈现font-sizecolor设置属性样式。 此代码示例使用 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当样式不是枚举的成员HtmlTextWriterStyle或直到运行时才知道时,请使用该方法的AddStyleAttribute(String, String)重载。

HtmlTextWriter 类维护呈现的标记元素的样式列表。 RenderBeginTag调用该方法时,该方法添加AddStyleAttribute的任何样式将呈现为元素的开始标记。 然后清除样式列表。

用于呈现标记元素的编码模式如下所示:

  • 使用该方法 AddStyleAttribute 向元素添加任何样式属性。

  • 使用 RenderBeginTag 方法。

  • 根据需要使用其他方法呈现元素开始标记和结束标记之间找到的内容。

  • 使用 RenderEndTag 方法。

另请参阅

适用于

AddStyleAttribute(HtmlTextWriterStyle, String)

对于通过对 HtmlTextWriterStyle 方法的后续调用而创建的开始标记,向其中添加与指定的 RenderBeginTag 值相关联的标记样式属性和属性值。

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

包含要分配给该属性的值的字符串。

示例

下面的代码示例演示如何在派生自HtmlTextWriter该类的类中使用方法的RenderBeginTag替代的一部分。 代码检查是否 <Label> 正在呈现元素。 如果是, IsStyleAttributeDefined 则调用该方法以检查 Color 是否已为 <Label> 元素定义样式属性。 Color如果未定义属性,代码将调用该方法的此重载AddStyleAttribute,以将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)
{
    // 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当样式是枚举的成员HtmlTextWriterStyle且在运行时之前已知时,请使用该方法的AddStyleAttribute(HtmlTextWriterStyle, String)重载。

HtmlTextWriter 类维护呈现的标记元素的样式列表。 RenderBeginTag调用该方法时,该方法添加AddStyleAttribute的任何样式将呈现为元素的开始标记。 然后清除样式列表。

用于呈现标记元素的编码模式如下所示:

  • 使用该方法 AddStyleAttribute 向元素添加任何样式属性。

  • 使用 RenderBeginTag 方法。

  • 根据需要使用其他方法呈现元素开始标记和结束标记之间找到的内容。

  • 使用 RenderEndTag 方法。

另请参阅

适用于

AddStyleAttribute(String, String, HtmlTextWriterStyle)

对于通过对 HtmlTextWriterStyle 方法的后续调用而创建的开始标记,向其中添加指定的标记样式属和属性值以及 RenderBeginTag 枚举值。

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重载。 它使你可以为HtmlTextWriterStyle属性创建新name值和value对。

另请参阅

适用于