XmlNode.InnerXml プロパティ

  • リファレンス

定義

名前空間:
System.Xml
アセンブリ:
System.Xml.dll, System.Xml.XmlDocument.dll
アセンブリ:
System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.XmlDocument.dll
アセンブリ:
System.Xml.dll
アセンブリ:
netstandard.dll

このノードの子ノードだけを表すマークアップを取得または設定します。

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

プロパティ値

String

既定の属性を含まない、このノードの子ノードのマークアップ。

例外

InvalidOperationException

子ノードを持つことができないノードでこのプロパティを設定します。

XmlException

このプロパティの設定時に指定される XML は、整形式ではありません。

例

次の例では、プロパティと比較InnerXmlしますInnerText。

#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

注釈

子ノードを持つことができないノード (Text ノードなど) からこのプロパティを設定しようとすると、例外がスローされます。 それ以外の場合、設定 InnerXml はノードの子ノードを、指定された文字列の解析された内容に置き換えます。 文字列の解析は、現在の名前空間コンテキストで実行されます。

このプロパティは、ドキュメント オブジェクト モデル (DOM) の Microsoft 拡張機能です。

注意

InnerXml は DOM を変更する効率的な方法ではありません。 複雑なノードを置き換えるときにパフォーマンスの問題が発生する可能性があります。 ノードを構築し、そのメソッドInsertBefore``InsertAfterを使用する方が効率的です 。、 AppendChild``RemoveChild Xml ドキュメントを変更します。

適用対象