HtmlTextWriter.WriteAttribute Method (String, String, Boolean)

Writes the specified markup attribute and value to the output stream, and, if specified, writes the value encoded.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

public:
virtual void WriteAttribute (
	String^ name, 
	String^ value, 
	bool fEncode
)
public void WriteAttribute (
	String name, 
	String value, 
	boolean fEncode
)
public function WriteAttribute (
	name : String, 
	value : String, 
	fEncode : boolean
)
Not applicable.

Parameters

name

The markup attribute to write to the output stream.

value

The value assigned to the attribute.

fEncode

true to encode the attribute and its assigned value; otherwise, false.

Use the WriteAttribute method to write markup attributes and their values with or without encoding. The WriteAttribute method uses the HtmlAttributeEncode method to do the encoding.

The WriteAttribute method writes the attribute value enclosed in double quotation marks ("). If value is a null reference (Nothing in Visual Basic), the WriteAttribute method writes only the attribute name.

Notes to Inheritors: In derived classes, you can override the WriteAttribute method to define custom rules for writing attributes and their values. For example, you could write code that allowed the WriteAttribute method to write an attribute with an empty value.

The following code example demonstrates rendering an <img> element in which both overloads of the WriteAttribute method are called. The code example uses the following process:

  • Calls the WriteBeginTag method, which renders the opening characters of the element.

  • Calls the WriteAttribute(String,String) overload, which writes an alt attribute and its value to the <img> element.

  • Calls the WriteAttribute(String,String,Boolean) overload to render a custom myattribute attribute, with a value of No "encoding" required, and then sets fEncode to false.

  • Closes the opening tag of the element, and then calls the WriteEndTag method to close the <img> element.

This code example generates the following markup:

<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 &quot;encoding &quot; 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 &quot;encoding &quot; required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: