HtmlElement.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 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, setPublic Property InnerHtml As StringValeur de propriété
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 .