HtmlContainerControl.InnerText Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o texto entre as etiquetas de abertura e fecho do controlo 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, setPublic Overridable Property InnerText As StringValor de Propriedade
O texto entre as etiquetas de abertura e fecho de um servidor HTML controla.
- Atributos
Exceções
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 o serviço de codificação HTML disponível através 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>
Observações
Use a InnerText propriedade para modificar programaticamente o texto entre as etiquetas de abertura e fecho de um controlo de servidor HTML.
Ao contrário da InnerHtml propriedade, esta InnerText 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 <.
Por exemplo, se a InnerText propriedade for definida como "<b> Hello </b>", os < símbolos e > são convertidos em < e >, respetivamente. A saída renderizada seria: < b Olá < /b >> . As < entidades e > indicariam ao navegador que estes caracteres devem ser exibidos na página. O navegador não deteta as <b> etiquetas nem exibe o texto em negrito. O texto exibido na página é: <b Olá </b>>.
Para evitar a codificação e descodificação automática de HTML, use a InnerHtml propriedade.
Note
Se não existirem controlos filhos, a InnerHtml propriedade contém o valor String.Empty.