This documentation is archived and is not being maintained.

ControlBuilder.HtmlDecodeLiterals Method

Determines whether the literal string of an HTML control must be HTML decoded. This method is called by the ASP.NET page framework.

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

public virtual bool HtmlDecodeLiterals()

Return Value

Type: System.Boolean
true if the HTML control literal string is to be decoded; otherwise, false.

A literal string refers to the text between the opening and closing tag of an HTML control. HTML encoding is when text is converted into a string representation that the browser will display rather than interpret as HTML. Characters such as the question mark (?), ampersand (&), slash mark (/), and spaces might be truncated or corrupted by some browsers, so those characters must be encoded when they appear in a tags or in query strings.

The HtmlDecodeLiterals method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.

The following example overrides the HtmlDecodeLiterals method to allow HTML decoding of literal strings in any control this builder is applied to.

        // Override the HtmlDecodeLiterals method to allow HTML 
        // decoding of literal strings in any controls this builder 
        // is applied to. 
		public override bool HtmlDecodeLiterals()
			return true;

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0