HtmlContainerControl.InnerText Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el texto que se encuentra entre las etiquetas de apertura y cierre del control 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 de propiedad
El texto incluido entre las etiquetas de apertura y cierre de un control de servidor HTML.
- Atributos
Excepciones
Hay más de un control de servidor HTML.
o bien
El control de servidor HTML no es LiteralControl ni DataBoundLiteralControl.
Ejemplos
En el ejemplo de código siguiente se muestra el servicio de codificación HTML disponible a través de la InnerText propiedad .
<%@ 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>
Comentarios
Utilice la InnerText propiedad para modificar mediante programación el texto entre las etiquetas de apertura y cierre de un control de servidor HTML.
A diferencia de la InnerHtml propiedad , la InnerText propiedad codifica automáticamente caracteres especiales hacia y desde entidades HTML. Las entidades HTML permiten mostrar caracteres especiales, como el <
carácter, que un explorador interpretaría normalmente como tener un significado especial. El <
carácter se interpretaría como el inicio de una etiqueta y no se muestra en la página. Para mostrar el <
carácter, tendría que usar la entidad <
.
Por ejemplo, si la InnerText propiedad se establece "<b> Hello </b>"
en , los <
símbolos y >
se convierten en <
y >
, respectivamente. La salida representada sería: < b > Hello < /b >. Las <
entidades y >
indicarían al explorador que se van a mostrar estos caracteres en la página. El explorador no detectará las <b>
etiquetas y mostrará el texto en una fuente 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áticas, use la InnerHtml propiedad .
Nota:
Si no hay ningún control secundario, la InnerHtml propiedad contiene el valor String.Empty.