Compartir por


HtmlElement.InnerHtml Propiedad

Definición

Obtiene o establece el marcado HTML debajo de este 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 de propiedad

Marcado HTML que define los elementos secundarios del elemento actual.

Excepciones

No se permite crear elementos secundarios en este elemento.

Comentarios

Hay varias maneras de agregar nuevos elementos a una página HTML existente, como los AppendChild métodos y InsertAdjacentElement . El uso InnerHtml suele ser la manera más rápida de agregar contenido nuevo cuando tiene que establecer muchos atributos o estilos en los nuevos elementos.

InnerHtml difiere de OuterHtml en que InnerHtml no incluirá el CÓDIGO HTML que representa el objeto al que se llama. Consulte OuterHtml para obtener más información sobre la diferencia entre estas dos propiedades.

Al establecer InnerHtml se destruyen los elementos secundarios previamente anexados al elemento . Si recupera un elemento del DOM y, a continuación, asigna nuevo HTML a la propiedad de InnerHtml sus elementos primarios, la referencia a ese elemento no será útil y su comportamiento cuando llama a sus propiedades y métodos no está definido.

Para algunos elementos, la configuración InnerHtml no es una operación válida. Algunas etiquetas HTML no tienen ninguna etiqueta de cierre, como la IMG etiqueta y, por tanto, no pueden contener elementos anidados. Algunas etiquetas, como la SCRIPT etiqueta , solo pueden contener contenido de texto; la configuración InnerHtml producirá un error. Para ambos tipos de etiquetas, la CanHaveChildren propiedad devolverá false. Sin embargo, tampoco se puede establecer InnerHtml en TABLE los elementos y TR , ya que la asignación de HTML con formato incorrecto a estos elementos podría dañar la representación del documento. Use AppendChild o los insertRow métodos y insertCell en la interfaz no administrada IHTMLTable para agregar filas y celdas a .TABLE

Si solo necesita asignar texto a un elemento y no a un marcado HTML, use la InnerText propiedad en su lugar.

La asignación de un valor a InnerHtml destruirá los valores de texto asignados anteriormente mediante InnerText.

Se aplica a

Consulte también