HtmlContainerControl.InnerHtml HtmlContainerControl.InnerHtml HtmlContainerControl.InnerHtml HtmlContainerControl.InnerHtml Property

Определение

Получает или задает содержимое между открывающим и закрывающим тегами указанного серверного элемента управления HTML.Gets or sets the content found between the opening and closing tags of the specified HTML server control.

public:
 virtual property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public virtual string InnerHtml { get; set; }
member this.InnerHtml : string with get, set
Public Overridable Property InnerHtml As String

Значение свойства

Содержимое HTML между открывающим и закрывающим тегами серверного элемента управления HTML.The HTML content between opening and closing tags of an HTML server control.

Исключения

Существует несколько серверных элементов управления HTML.There is more than one HTML server control.

- или --or- Серверный элемент управления HTML не является LiteralControl или DataBoundLiteralControl.The HTML server control is not a LiteralControl or a DataBoundLiteralControl.

Примеры

В следующем примере кода показано, как использовать InnerHtml свойство для динамического задания текстового сообщения.The following code example demonstrates how to use the InnerHtml property to dynamically set a text message.

<%@ 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 sender, EventArgs e)
  {
    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " + DateTime.Now);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlContainerControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="Message" runat="server"></span>    
    </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 sender As Object, ByVal e As System.EventArgs)

    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " & DateTime.Now)

  End Sub

</script>

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

Комментарии

InnerHtml Используйте свойство для программного изменения содержимого между открывающим и закрывающим тегами серверного элемента управления HTML.Use the InnerHtml property to programmatically modify the contents between the opening and closing tags of an HTML server control.

InnerHtml Свойство не кодирует автоматически специальные символы в сущности HTML и обратно.The InnerHtml property does not automatically encode special characters to and from HTML entities. Объекты HTML позволяют отображать специальные символы, например < символы, которые браузер обычно интерпретирует как имеющий особое значение.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. Чтобы отобразить < символ, необходимо использовать сущность &lt;.To display the < character, you would need to use the entity &lt;.

Например InnerHtml , если свойство имеет "<b> Hello </b>"значение, < символы и > не преобразуются в &lt; и &gt;соответственно.For example, if the InnerHtml property is set to "<b> Hello </b>", the < and > characters are not converted to &lt; and &gt;, respectively. Отображаемые выходные данные по-прежнему <будут: b <> Привет/b >.The rendered output would still be: <b> Hello </b>. Браузер обнаружит <b> Теги и выведет текст Hello полужирным шрифтом.The browser will detect the <b> tags and display the text, Hello, in a bold font.

Внимание!

Поскольку текст не кодируется в формате HTML, можно внедрить сценарий в HTML-теги в тексте.Because the text is not HTML encoded, it possible to embed script within HTML tags in the text. Если это свойство задано динамически с помощью пользовательского ввода, обязательно проверьте значение, чтобы снизить уязвимость системы безопасности.If this property is set dynamically using user input, be sure to validate the value to reduce security vulnerabilities. Дополнительные сведения см. в разделе безопасность и ввод данных пользователем.For more information, see Security and User Input.

Чтобы обеспечить автоматическую кодировку и декодирование HTML, InnerText используйте свойство.To provide automatic HTML encoding and decoding, use the InnerText property.

Примечание

Если дочерние элементы управления отсутствуют, InnerHtml свойство содержит значение. String.EmptyIf there are no child controls, the InnerHtml property contains the value String.Empty.

Применяется к

Дополнительно