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. Consultez OuterHtml pour plus d’informations sur la différence entre ces deux propriétés.
Le paramètre InnerHtml détruit les enfants précédemment ajoutés à l’élément. Si vous récupérez un élément à partir du DOM, puis attribuez un nouveau code HTML à la propriété de InnerHtml ses parents, 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 fermante, telle que la IMG balise, et ne peuvent donc pas contenir d’éléments imbriqués. Certaines balises, telles que la SCRIPT balise, peuvent contenir uniquement du contenu texte ; le paramètre InnerHtml entraîne une erreur. Pour les deux types de balises, la CanHaveChildren propriété retourne false. Toutefois, vous ne pouvez pas également définir InnerHtml sur TABLE et TR les éléments, car l’affectation de code HTML mal formé à ces éléments peut endommager le rendu du document. Utilisez ou utilisez insertRowAppendChildinsertCell ou les méthodes sur l’interface non managée IHTMLTable pour ajouter des lignes et des cellules à un .TABLE
Si vous devez uniquement affecter du texte à un élément et non au balisage HTML, utilisez la propriété à la InnerText place.
L’affectation d’une valeur pour InnerHtml détruire toutes les valeurs de texte précédemment affectées à l’aide InnerTextde .
