HtmlContainerControl.InnerText Property

Reference

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 virtual property System::String ^ InnerText { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public virtual string InnerText { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.InnerText : string with get, set

Public Overridable Property InnerText As String

Property Value

String

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

Attributes: BrowsableAttribute

Exceptions

HttpException

There is more than one HTML server control.

-or-

The HTML server control is not a LiteralControl or a DataBoundLiteralControl.

Examples

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

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(Object Src, EventArgs E)
  {
    Message.InnerText = "To make text bold, use the <b> tag.";
    
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlContainerControl Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    <div>
    <b><span id="Message" runat="server"></span></b>
    </div>
    </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal Src As Object, ByVal E As EventArgs)
    
    Message.InnerText = "To make text bold, use the <b> tag."
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
    <title>HtmlContainerControl Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    <div>
    <b><span id="Message" runat="server"></span></b>
    </div>
    </form>
  </body>
</html>

Remarks

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 <.

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

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

Note

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

Applies to