HtmlElement.InnerHtml Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a marcação HTML por baixo deste elemento.
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 StringValor de Propriedade
A marcação HTML que define os elementos filhos do elemento atual.
Exceções
Não é permitido criar elementos filhos neste elemento.
Observações
Existem várias formas de adicionar novos elementos a uma página HTML existente, como os AppendChild métodos and InsertAdjacentElement . Usar InnerHtml é frequentemente a forma mais rápida de adicionar novo conteúdo quando tem de definir muitos atributos ou estilos nos seus novos elementos.
InnerHtml difere de OuterHtml que InnerHtml não inclui o HTML que representa o objeto que está a chamar. Consulte OuterHtml para mais informações sobre a diferença entre estas duas propriedades.
O cenário InnerHtml destrói quaisquer crianças previamente anexadas ao elemento. Se recuperares um elemento do DOM e depois atribuires novo HTML à propriedade dos InnerHtml seus pais, a tua referência a esse elemento será inútil, e o seu comportamento ao chamar as suas propriedades e métodos fica indefinido.
Para alguns elementos, definir InnerHtml não é uma operação válida. Algumas etiquetas HTML não têm etiqueta de fecho, como a IMG etiqueta, e por isso não podem conter elementos aninhados. Algumas etiquetas, como a etiqueta, SCRIPT só podem conter conteúdo de texto; a definição InnerHtml resultará num erro. Para ambos os tipos de etiquetas, a CanHaveChildren propriedade devolverá false. No entanto, também não pode definir InnerHtml elementos TABLE and, TR pois atribuir HTML mal formado a esses elementos pode corromper a renderização do documento. Use ou os insertRow métodos e insertCell na interface não gerida IHTMLTable para adicionar linhas e células a um TABLE.AppendChild
Se só precisares de atribuir texto a um elemento e não marcação HTML, usa a InnerText propriedade em vez disso.
Atribuir um valor a InnerHtml destruirá quaisquer valores de texto previamente atribuídos usando InnerText.