Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
HtmlContainerControl.InnerText (Propiedad)
Obtiene o establece el texto que se encuentra entre las etiquetas de apertura y cierre del control de servidor HTML especificado.
Ensamblado: System.Web (en System.Web.dll)
| Excepción | Condición |
|---|---|
| HttpException |
Hay más de un control de servidor HTML. ‑O bien- El control de servidor HTML no es System.Web.UI.LiteralControl ni System.Web.UI.DataBoundLiteralControl. |
La propiedad InnerText se puede utilizar para modificar mediante programación el texto comprendido entre las etiquetas de apertura y cierre de un control de servidor HTML.
A diferencia de la propiedad InnerHtml, la propiedad InnerText no codifica automáticamente los caracteres especiales en entidades HTML y desde las mismas. Las entidades HTML permiten mostrar caracteres especiales, como el carácter <, que un explorador interpretaría normalmente que tiene un significado especial. El carácter < se interpretaría como el inicio de una etiqueta y no se mostraría en la página. Para mostrar el carácter <, habría que usar la entidad <.
Por ejemplo, si la propiedad InnerText se establece en "<b> Hello </b>", los símbolos < y > se convierten en < y >, respectivamente. El resultado representado sería : < b > Hello < /b >. Las entidades < y > indicarían al explorador que estos caracteres deben mostrarse en la página. El explorador no detectaría las etiquetas <b> y mostraría el texto en negrita. El texto que se muestra en la página es: <b> Hello </b>.
Para evitar la codificación y descodificación HTML automática, hay que utilizar la propiedad InnerHtml.
Nota
|
|---|
|
Si no hay controles secundarios, la propiedad InnerHtml contendrá el valor String.Empty. |
En este ejemplo se muestra el servicio de codificación HTML disponible mediante la propiedad 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>
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Nota