HtmlContainerControl.InnerHtml 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 contenu trouvé 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é
Contenu HTML 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 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 les 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è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 InnerHtml propriété est définie "<b> Hello </b>"sur , les caractères et > les < caractères ne sont pas convertis en < et >, 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.
Avertissement
É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 de l’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 l’encodage et le décodage HTML automatiques, utilisez la InnerText propriété.
Note
S’il n’existe aucun contrôle enfant, la InnerHtml propriété contient la valeur String.Empty.