XmlNode.InnerXml Vlastnost

Definice

Obor názvů:

System.Xml

Sestavení:

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

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.XmlDocument.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Získá nebo nastaví revize představující pouze podřízené uzly tohoto uzlu.

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

Hodnota vlastnosti

String

Revize podřízených uzlů tohoto uzlu, nikoli včetně výchozích atributů.

Výjimky

InvalidOperationException

Nastavení této vlastnosti na uzlu, který nemůže obsahovat podřízené uzly.

XmlException

Xml zadaný při nastavení této vlastnosti není správně vytvořen.

Příklady

Následující příklad porovnává InnerText vlastnosti a vlastnosti 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

Poznámky

Při pokusu o nastavení této vlastnosti z uzlu, který nemůže mít podřízené uzly, například textový uzel, vyvolá výjimku. Jinak nastavení InnerXml nahradí podřízené uzly uzlu parsovaným obsahem daného řetězce. Analýza se provádí v aktuálním kontextu oboru názvů.

Tato vlastnost je rozšíření Microsoftu pro model objektu dokumentu (DOM).

Poznámka

InnerXml není efektivní způsob, jak upravit DOM. Při nahrazení složitých uzlů může dojít k problémům s výkonem. Je efektivnější vytvářet uzly a používat metody, jako jsou InsertBefore, InsertAfter, AppendChilda RemoveChild upravit dokument Xml.