Compartilhar via


HtmlElement.InnerHtml Propriedade

Definição

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, set
Public Property InnerHtml As String

Valor da propriedade

String

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.

Aplica-se a

Confira também