This documentation is archived and is not being maintained.

HtmlTextWriter.WriteEncodedText Method

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.


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

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.