HtmlTextWriter.WriteAttribute 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

将标记属性及其值写入到输出流。

重载

WriteAttribute(String, String, Boolean)	将指定标记特性和值写入输出流，并且（如果指定）写入经过编码的值。
WriteAttribute(String, String)	将指定的标记属性和值写入到输出流。

WriteAttribute(String, String, Boolean)

将指定标记特性和值写入输出流，并且（如果指定）写入经过编码的值。

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);

public virtual void WriteAttribute (string name, string value, bool fEncode);

abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit

Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

参数

name

String

要写入输出流的标记特性。

value

String

要分配给特性的值。

fEncode

Boolean

若要对特性及其分配值进行编码，则为 true；否则为 false。

示例

下面的代码示例演示如何呈现调用 方法的两个 <img> 重载的 WriteAttribute 元素。 该代码示例使用以下过程：

• WriteBeginTag调用 方法，该方法呈现 元素的开始字符。

• WriteAttribute(String, String)调用 重载，该重载将alt特性及其值写入<img>元素。

• WriteAttribute(String, String, Boolean)调用 重载以呈现值为 的No "encoding" required自定义myattribute属性，然后将 设置为 fEncodefalse。

• 关闭元素的开始标记，然后调用 WriteEndTag 方法来关闭元素 <img> 。

此代码示例生成以下标记：

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

注解

WriteAttribute使用 方法可以编写带或不带编码的标记属性及其值。 方法 WriteAttribute 使用 HtmlAttributeEncode 方法进行编码。

方法 WriteAttribute 将用双引号括起来的属性值写入 (“) 。 如果 value 为 null，则 WriteAttribute 该方法仅写入属性名称。

继承者说明

在派生类中，可以重写 方法， WriteAttribute(String, String, Boolean) 以定义用于写入特性及其值的自定义规则。 例如，可以编写允许 WriteAttribute(String, String, Boolean) 方法编写具有空值的属性的代码。

另请参阅

• TextWriter
• HtmlAttributeEncode(String, TextWriter)

WriteAttribute(String, String)

将指定的标记属性和值写入到输出流。

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);

public virtual void WriteAttribute (string name, string value);

abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit

Public Overridable Sub WriteAttribute (name As String, value As String)

参数

name

String

要写入到输出流的属性。

value

String

要分配给特性的值。

示例

下面的代码示例演示如何呈现调用 方法的两个 <img> 重载的 WriteAttribute 元素。 该代码示例使用以下过程：

• WriteBeginTag调用 方法，该方法呈现 元素的开始字符。

• WriteAttribute(String, String)调用 重载，该重载将alt特性及其值写入<img>元素。

• WriteAttribute(String, String, Boolean)调用 重载以呈现值为 的No "encoding" required自定义myattribute属性，然后将 设置为 fEncodefalse。

• 关闭元素的开始标记，然后调用 WriteEndTag 方法来关闭元素 <img> 。

此代码示例生成以下标记：

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

注解

WriteAttribute使用 方法编写标记属性及其值，不带编码。 方法 WriteAttribute 将用双引号括起来的属性值写入 (“) 。 如果 value 为 null，则 WriteAttribute 该方法仅写入属性名称。

继承者说明

在派生类中，可以重写 方法， WriteAttribute(String, String) 以定义用于写入特性及其值的自定义规则。 例如，可以编写允许 WriteAttribute(String, String) 方法编写具有空值的属性的代码。

另请参阅

• TextWriter