HtmlContainerControl.InnerText Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает текст между открывающим и закрывающим тегами указанного элемента управления HTML-сервера.
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
Значение свойства
Текст между открывающим и закрывающим тегами элемента управления HTML-сервера.
- Атрибуты
Исключения
Существует несколько элементов управления HTML-сервера.
–или–
Элемент управления HTML-сервера не является или не LiteralControl является DataBoundLiteralControl.
Примеры
В следующем примере кода показана служба кодирования HTML, доступная через InnerText свойство.
<%@ 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>
Комментарии
InnerText Используйте свойство для программного изменения текста между открывающим и закрывающим тегами элемента управления СЕРВЕРА HTML.
InnerHtml В отличие от свойства, InnerText свойство автоматически кодирует специальные символы в сущности HTML и из нее. Сущности HTML позволяют отображать специальные символы, такие как < символ, который браузер обычно интерпретирует как специальный смысл. Символ < будет интерпретирован как начало тега и не отображается на странице. Чтобы отобразить < символ, необходимо использовать сущность <.
Например, если свойству InnerText присвоено значение "<b> Hello </b>", < то > символы преобразуются < в и >соответственно. Выходные данные отрисовки: < b > Hello < /b >.
> Сущности < указывают браузеру, что эти символы должны отображаться на странице. Браузер не будет обнаруживать <b> теги и отображать текст в полужирном шрифте. Текст, отображаемый на странице: <b Hello </b>>.
Чтобы предотвратить автоматическую InnerHtml кодировку HTML и декодирование, используйте это свойство.
Замечание
Если дочерние элементы управления отсутствуют, InnerHtml свойство содержит значение String.Empty.