HtmlContainerControl.InnerHtml 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 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é <.

Par exemple, si la propriété a la InnerHtml" Hello "valeur , les < caractères et > ne sont pas convertis < en et >, respectivement. La sortie rendue est toujours : Hello . Le navigateur détecte les  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 à

Partager via