HtmlElement.InnerHtml Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.