HtmlContainerControl.InnerText Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Obtém ou define o texto entre as marcas de abertura e fechamento do controle de servidor HTML especificado.

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

Valor da propriedade

String

O texto entre as marcas de abertura e fechamento de um controle de servidor HTML.

Atributos
BrowsableAttribute

Exceções

HttpException

Há mais de um controle de servidor HTML.

- ou -

O controle de servidor HTML não é um LiteralControl ou um DataBoundLiteralControl.

Exemplos

O exemplo de código a seguir demonstra o serviço de codificação HTML disponível por meio da InnerText propriedade .

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

Comentários

Use a InnerText propriedade para modificar programaticamente o texto entre as marcas de abertura e fechamento de um controle de servidor HTML.

Ao contrário da InnerHtml propriedade , a InnerText propriedade codifica automaticamente caracteres especiais de e para entidades HTML. As entidades HTML permitem que você exiba caracteres especiais, como o < caractere , que um navegador normalmente interpretaria como tendo um significado especial. O < caractere seria interpretado como o início de uma marca e não é exibido na página. Para exibir o < caractere, você precisaria usar a entidade &lt;.

Por exemplo, se a InnerText propriedade for definida "<b> Hello </b>"como , os < símbolos e > serão convertidos &lt; em e &gt;, respectivamente. A saída renderizada seria: < b > Hello < /b >. As &lt; entidades e &gt; indicam ao navegador que esses caracteres devem ser exibidos na página. O navegador não detectará as <b> marcas e exibirá o texto em negrito. O texto exibido na página é: <b> Hello </b>.

Para evitar a codificação e a decodificação de HTML automáticas, use a InnerHtml propriedade .

Observação

Se não houver controles filho, a InnerHtml propriedade conterá o valor String.Empty.

Aplica-se a

Confira também