XmlNode.InnerXml Propiedad

Definición

Espacio de nombres:

System.Xml

Ensamblados:

System.Xml.dll, System.Xml.XmlDocument.dll

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.XmlDocument.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Obtiene o establece el marcado que representa solo los nodos secundarios de este nodo.

public:
 virtual property System::String ^ InnerXml { System::String ^ get(); void set(System::String ^ value); };

public virtual string InnerXml { get; set; }

member this.InnerXml : string with get, set

Public Overridable Property InnerXml As String

Valor de propiedad

String

Marcado de los nodos secundarios de este nodo, no incluidos los atributos predeterminados.

Excepciones

InvalidOperationException

Establecer esta propiedad en un nodo que no puede tener secundarios.

XmlException

El código XML especificado al establecer esta propiedad no es correcto.

Ejemplos

En el ejemplo siguiente se comparan las InnerText propiedades y InnerXml .

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<root>"
   "<elem>some text<child/>more text</elem>"
   "</root>" );
   XmlNode^ elem = doc->DocumentElement->FirstChild;
   
   // Note that InnerText does not include the markup.
   Console::WriteLine( "Display the InnerText of the element..." );
   Console::WriteLine( elem->InnerText );
   
   // InnerXml includes the markup of the element.
   Console::WriteLine( "Display the InnerXml of the element..." );
   Console::WriteLine( elem->InnerXml );
   
   // Set InnerText to a string that includes markup.  
   // The markup is escaped.
   elem->InnerText = "Text containing <markup/> will have char(<) and char(>) escaped.";
   Console::WriteLine( elem->OuterXml );
   
   // Set InnerXml to a string that includes markup.  
   // The markup is not escaped.
   elem->InnerXml = "Text containing <markup/>.";
   Console::WriteLine( elem->OuterXml );
}

using System;
using System.Xml;
public class Test {

  public static void Main() {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<root>"+
                "<elem>some text<child/>more text</elem>" +
                "</root>");

    XmlNode elem = doc.DocumentElement.FirstChild;

    // Note that InnerText does not include the markup.
    Console.WriteLine("Display the InnerText of the element...");
    Console.WriteLine( elem.InnerText );

    // InnerXml includes the markup of the element.
    Console.WriteLine("Display the InnerXml of the element...");
    Console.WriteLine(elem.InnerXml);

    // Set InnerText to a string that includes markup.
    // The markup is escaped.
    elem.InnerText = "Text containing <markup/> will have char(<) and char(>) escaped.";
    Console.WriteLine( elem.OuterXml );

    // Set InnerXml to a string that includes markup.
    // The markup is not escaped.
    elem.InnerXml = "Text containing <markup/>.";
    Console.WriteLine( elem.OuterXml );
  }
}

Imports System.Xml

public class Test

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<root>"& _
                "<elem>some text<child/>more text</elem>" & _
                "</root>")

    Dim elem as XmlNode = doc.DocumentElement.FirstChild

    ' Note that InnerText does not include the markup.
    Console.WriteLine("Display the InnerText of the element...")
    Console.WriteLine( elem.InnerText )

    ' InnerXml includes the markup of the element.
    Console.WriteLine("Display the InnerXml of the element...")
    Console.WriteLine(elem.InnerXml)

    ' Set InnerText to a string that includes markup.  
    ' The markup is escaped.
    elem.InnerText = "Text containing <markup/> will have char(<) and char(>) escaped."
    Console.WriteLine( elem.OuterXml )

    ' Set InnerXml to a string that includes markup.  
    ' The markup is not escaped.
    elem.InnerXml = "Text containing <markup/>."
    Console.WriteLine( elem.OuterXml )
    
  end sub
end class

Comentarios

Al intentar establecer esta propiedad desde un nodo que no puede tener nodos secundarios, por ejemplo, un nodo Texto, produce una excepción. De lo contrario, la configuración InnerXml reemplaza los nodos secundarios del nodo por el contenido analizado de la cadena especificada. El análisis se realiza en el contexto del espacio de nombres actual.

Esta propiedad es una extensión de Microsoft para Document Object Model (DOM).

Nota

InnerXml no es una manera eficaz de modificar el DOM. Puede haber problemas de rendimiento al reemplazar nodos complejos. Es más eficaz construir nodos y usar métodos como InsertBefore, InsertAfter, AppendChildy RemoveChild para modificar el documento Xml.