Export (0) Print
Expand All

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;

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft