HtmlElement.InnerHtml Propiedad

Definición

Obtiene o establece el código HTML situado por 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

String

Código HTML que define los elementos secundarios del elemento actual.

Excepciones

No se permite la creación de elementos secundarios de 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 forma más rápida de agregar contenido nuevo cuando tenga 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 anexados previamente al elemento . Si recupera un elemento del DOM y, a continuación, asigna un nuevo CÓDIGO HTML a la propiedad de InnerHtml sus elementos primarios, la referencia a ese elemento será inú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 previamente mediante InnerText.

Se aplica a

Consulte también