HtmlContainerControl.InnerText Property

Gets or sets the text between the opening and closing tags of the specified HTML server control.

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

public:
virtual property String^ InnerText {
	String^ get ();
	void set (String^ value);
}
/** @property */
public String get_InnerText ()

/** @property */
public void set_InnerText (String value)

public function get InnerText () : String

public function set InnerText (value : String)

Property Value

The text between the opening and closing tags of an HTML server control.

Exception typeCondition

HttpException

There is more than one HTML server control.

- or -

The HTML server control is not a System.Web.UI.LiteralControl or a System.Web.UI.DataBoundLiteralControl.

Use the InnerText property to programmatically modify the text between the opening and closing tags of an HTML server control.

Unlike the InnerHtml property, the InnerText property automatically encodes special characters to and from HTML entities. HTML entities allow you to display special characters, such as the < character, that a browser would ordinarily interpret as having special meaning. The < character would be interpreted as the start of a tag and is not displayed on the page. To display the < character, you would need to use the entity &lt;.

For example, if the InnerText property is set to "<b> Hello </b>", the < and > symbols are converted to &lt; and &gt;, respectively. The rendered output would be: &lt; b &gt; Hello &lt; /b &gt;. The &lt; and &gt; entities would indicate to the browser that these characters are to be displayed on the page. The browser will not detect the <b> tags and display the text in a bold font. The text displayed on the page is: <b> Hello </b>.

To prevent automatic HTML encoding and decoding, use the InnerHtml property.

NoteNote

If there are no child controls, the InnerHtml property contains the value String.Empty.

The following code example demonstrates the HTML encoding service available through the InnerText property.

No code example is currently available or this language may not be supported.

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

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show: