HtmlContainerControl.InnerText Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit le texte entre les balises d’ouverture et de fermeture du contrôle serveur HTML spécifié.
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
Valeur de propriété
Texte entre les balises d’ouverture et de fermeture d’un contrôle serveur HTML.
- Attributs
Exceptions
Il existe plusieurs contrôles de serveur HTML.
- ou -
Le contrôle serveur HTML n’est pas un LiteralControl ou un DataBoundLiteralControl.
Exemples
L’exemple de code suivant illustre le service d’encodage HTML disponible via la InnerText propriété.
<%@ 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>
Remarques
Utilisez la InnerText propriété pour modifier par programmation le texte entre les balises d’ouverture et de fermeture d’un contrôle serveur HTML.
Contrairement à la InnerHtml propriété, la InnerText propriété encode automatiquement des caractères spéciaux vers et depuis des entités HTML. Les entités HTML vous permettent d’afficher des caractères spéciaux, tels que le < caractère, qu’un navigateur interprète généralement comme ayant une signification particulière. Le < caractère est interprété comme le début d’une balise et n’est pas affiché sur la page. Pour afficher le < caractère, vous devez utiliser l’entité <.
Par exemple, si la InnerText propriété est définie "<b> Hello </b>"sur , les < symboles et > les symboles sont convertis en < et >, respectivement. La sortie rendue est : < b > Hello < /b >. Les < entités indiquent > au navigateur que ces caractères doivent être affichés sur la page. Le navigateur ne détecte pas les <b> balises et affiche le texte dans une police en gras. Le texte affiché sur la page est : <b> Hello </b>.
Pour empêcher l’encodage et le décodage HTML automatiques, utilisez la InnerHtml propriété.
Note
S’il n’existe aucun contrôle enfant, la InnerHtml propriété contient la valeur String.Empty.