HtmlTextWriter.WriteEncodedText Method (String)


Encodes the specified text for the requesting device, and then writes it to the output stream.

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

public virtual void WriteEncodedText(
	string text


Type: System.String

The text string to encode and write to the output stream.

Exception Condition

text is null.

Use the WriteEncodedText method when a string contains angle brackets (< or >) or an ampersand (&).

The WriteEncodedText method uses the HtmlEncode method to perform the encoding and also converts Unicode character 00A0 to &nbsp;.

The following code example shows how to use the WriteEncodedText method to write the encoded markup &lt;custID&gt; &amp; &lt;invoice#&gt; to the output stream. The WriteBreak method writes <br />.

// Assign a value to a string variable,
// encode it, and write it to a page.
colHeads = "<custID> & <invoice#>"; 

.NET Framework
Available since 2.0
Return to top