HtmlContainerControl.InnerHtml Propriété

  • Référence

Définition

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

Obtient ou définit le contenu compris entre les balises d'ouverture et de fermeture du contrôle serveur HTML spécifié.

public:
 virtual property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public virtual string InnerHtml { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.InnerHtml : string with get, set
Public Overridable Property InnerHtml As String

Valeur de propriété

String

Contenu HTML 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 montre comment utiliser la InnerHtml propriété pour définir dynamiquement un message texte.

<%@ 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 sender, EventArgs e)
  {
    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " + DateTime.Now);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlContainerControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="Message" runat="server"></span>    
    </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 sender As Object, ByVal e As System.EventArgs)

    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " & DateTime.Now)

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HtmlContainerControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="Message" runat="server"></span>    
    </div>
    </form>
</body>
</html>

Remarques

Utilisez la InnerHtml propriété pour modifier par programmation le contenu entre les balises d’ouverture et de fermeture d’un contrôle serveur HTML.

La InnerHtml propriété n’encode pas 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é &lt;.

Par exemple, si la propriété a la InnerHtml"<b> Hello </b>"valeur , les < caractères et > ne sont pas convertis &lt; en et &gt;, respectivement. La sortie rendue est toujours : <b> Hello </b>. Le navigateur détecte les <b> balises et affiche le texte, Hello, dans une police en gras.

Attention

Étant donné que le texte n’est pas encodé au format HTML, il est possible d’incorporer un script dans des balises HTML dans le texte. Si cette propriété est définie dynamiquement à l’aide d’une entrée utilisateur, veillez à valider la valeur pour réduire les vulnérabilités de sécurité. Pour plus d’informations, consultez Sécurité et entrée utilisateur.

Pour fournir un encodage et un décodage HTML automatiques, utilisez la InnerText propriété .

Notes

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

S’applique à

Voir aussi