HtmlContainerControl.InnerHtml Propriedade

Definição

Espaço de Nomes:
System.Web.UI.HtmlControls
Assemblagem:
System.Web.dll

Obtém ou define o conteúdo encontrado entre as etiquetas de abertura e fecho do controlo HTML do servidor especificado.

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

Valor de Propriedade

String

O conteúdo HTML entre as etiquetas de abertura e fecho de um servidor HTML controla.

Atributos
BrowsableAttribute

Exceções

HttpException

Existem mais do que um controlo de servidor HTML.

-ou-

O controlo do servidor HTML não é um LiteralControl nem um DataBoundLiteralControl.

Exemplos

O exemplo de código seguinte demonstra como usar a InnerHtml propriedade para definir dinamicamente uma mensagem de texto.

<%@ 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>

Observações

Use a InnerHtml propriedade para modificar programaticamente o conteúdo entre as etiquetas de abertura e fecho de um controlo de servidor HTML.

A InnerHtml propriedade não codifica automaticamente caracteres especiais para e a partir de entidades HTML. As entidades HTML permitem-lhe mostrar caracteres especiais, como o < carácter, que um navegador normalmente interpretaria como tendo um significado especial. O < carácter seria interpretado como o início de uma etiqueta e não é apresentado na página. Para exibir o < carácter, terias de usar a entidade &lt;.

Por exemplo, se a InnerHtml propriedade for definida para "<b> Hello </b>", os < caracteres e > não são convertidos em &lt; e &gt;, respetivamente. A saída renderizada continuaria a ser: <b> Olá </b>. O navegador irá detetar as <b> etiquetas e mostrar o texto, Olá, em letra a negrito.

Caution

Como o texto não está codificado em HTML, é possível incorporar scripts dentro de tags HTML no texto. Se esta propriedade for definida dinamicamente usando input do utilizador, certifique-se de validar o valor para reduzir vulnerabilidades de segurança. Para mais informações, consulte Segurança e Entrada do Utilizador.

Para fornecer codificação e descodificação automática em HTML, use a InnerText propriedade.

Note

Se não existirem controlos filhos, a InnerHtml propriedade contém o valor String.Empty.

Aplica-se a

Ver também