HtmlContainerControl.InnerText Propriété

Référence

Définition

Espace de noms:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

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 compris 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é

String

Texte compris entre les balises d'ouverture et de fermeture d'un contrôle serveur HTML.

Attributs: BrowsableAttribute

Exceptions

HttpException

Il existe plusieurs contrôles serveur HTML.

- ou -

Le contrôle serveur HTML n'est pas LiteralControl ou 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 à partir d’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éterait généralement comme ayant une signification spéciale. 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é a la valeur " Hello ", les < symboles et > sont convertis < en et >, respectivement. La sortie rendue est : Hello . Les < entités et > indiquent au navigateur que ces caractères doivent être affichés sur la page. Le navigateur ne détecte pas les  balises et n’affiche pas le texte dans une police en gras. Le texte affiché sur la page est : Hello .

Pour empêcher l’encodage et le décodage HTML automatiques, utilisez la InnerHtml propriété .

Notes

S’il n’existe aucun contrôle enfant, la InnerHtml propriété contient la valeur String.Empty.

S’applique à

Voir aussi

InnerHtml