Partager via


HtmlElement.InnerHtml Propriété

Définition

Obtient ou définit le balisage HTML sous cet élément.

public:
 property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };
public string InnerHtml { get; set; }
member this.InnerHtml : string with get, set
Public Property InnerHtml As String

Valeur de propriété

String

Balisage HTML qui définit les éléments enfants de l'élément actuel.

Exceptions

La création d’éléments enfants sur cet élément n’est pas autorisée.

Remarques

Il existe plusieurs façons d’ajouter de nouveaux éléments à une page HTML existante, comme les méthodes et InsertAdjacentElement les AppendChild méthodes. L’utilisation InnerHtml est souvent le moyen le plus rapide d’ajouter du nouveau contenu lorsque vous devez définir de nombreux attributs ou styles sur vos nouveaux éléments.

InnerHtml diffère de OuterHtml ce qui InnerHtml n’inclut pas le code HTML qui représente l’objet que vous appelez. Pour OuterHtml plus d’informations sur la différence entre ces deux propriétés.

Le paramètre InnerHtml détruit tous les enfants précédemment ajoutés à l’élément. Si vous récupérez un élément du DOM, puis attribuez un nouveau code HTML à la propriété de ses parents InnerHtml , votre référence à cet élément sera inutile et son comportement lorsqu’il appelle ses propriétés et méthodes n’est pas défini.

Pour certains éléments, le paramètre InnerHtml n’est pas une opération valide. Certaines balises HTML n’ont aucune balise de fermeture, telle que la IMG balise, et ne peuvent donc pas contenir d’éléments imbriqués. Certaines balises, telles que la SCRIPT balise, ne peuvent contenir que du contenu texte ; le paramètre InnerHtml entraîne une erreur. Pour les deux types d’étiquettes, la CanHaveChildren propriété retourne false. Toutefois, vous ne pouvez pas également définir InnerHtml sur TABLE et TR les éléments, car l’attribution d’un code HTML mal formé à ces éléments peut endommager le rendu du document. Utilisez ou les insertRow AppendChild insertCell méthodes de l’interface non managée IHTMLTable pour ajouter des lignes et des cellules à un TABLE.

Si vous n’avez besoin que d’affecter du texte à un élément et non au balisage HTML, utilisez plutôt la InnerText propriété.

L’attribution d’une valeur pour InnerHtml détruire les valeurs de texte précédemment affectées à l’aide InnerTextde .

S’applique à

Voir aussi