HtmlElement.InnerHtml Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a marcação HTML embaixo desse 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 da propriedade
A marcação HTML que define os elementos filho do elemento atual.
Exceções
Não é permitida a criação de elementos filho neste elemento.
Comentários
Há várias maneiras de adicionar novos elementos a uma página HTML existente, como os métodos e InsertAdjacentElement os AppendChild métodos. O uso InnerHtml geralmente é a maneira mais rápida de adicionar novo conteúdo quando você precisa definir muitos atributos ou estilos em seus novos elementos.
InnerHtml difere do OuterHtml que InnerHtml não incluirá o HTML que representa o objeto que você está chamando. Confira OuterHtml mais informações sobre a diferença entre essas duas propriedades.
A configuração InnerHtml destrói todas as crianças acrescentadas anteriormente ao elemento. Se você recuperar um elemento do DOM e atribuir um novo HTML à propriedade de InnerHtml seus pais, sua referência a esse elemento será inútil e seu comportamento quando ele chamar suas propriedades e métodos será indefinido.
Para alguns elementos, a configuração InnerHtml não é uma operação válida. Algumas marcas HTML não têm nenhuma marca de fechamento, como a IMG marca e, portanto, não podem conter elementos aninhados. Algumas marcas, como a SCRIPT marca, só podem conter conteúdo de texto; a configuração InnerHtml resultará em um erro. Para ambos os tipos de marcas, a CanHaveChildren propriedade retornará false. No entanto, você também não pode definir InnerHtml TABLE e TR elementos, pois atribuir HTML malformado a esses elementos pode corromper a renderização do documento. Use AppendChild ou os insertRow métodos e insertCell na interface não gerenciada IHTMLTable para adicionar linhas e células a um TABLE.
Se você precisar apenas atribuir texto a um elemento e não à marcação HTML, use a InnerText propriedade.
Atribuir um valor destruirá InnerHtml todos os valores de texto atribuídos anteriormente usando InnerText.