XmlDocument.CreateDocumentFragment Method

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlDocument.cs

Creates an XmlDocumentFragment.

public:
 virtual System::Xml::XmlDocumentFragment ^ CreateDocumentFragment();

public virtual System.Xml.XmlDocumentFragment CreateDocumentFragment ();

abstract member CreateDocumentFragment : unit -> System.Xml.XmlDocumentFragment
override this.CreateDocumentFragment : unit -> System.Xml.XmlDocumentFragment

Public Overridable Function CreateDocumentFragment () As XmlDocumentFragment

Returns

XmlDocumentFragment

The new XmlDocumentFragment.

Examples

The following example adds new nodes to an XML document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<items/>" );
   
   //Create a document fragment.
   XmlDocumentFragment^ docFrag = doc->CreateDocumentFragment();
   
   //Set the contents of the document fragment.
   docFrag->InnerXml = "<item>widget</item>";
   
   //Add the children of the document fragment to the
   //original document.
   doc->DocumentElement->AppendChild( docFrag );
   Console::WriteLine( "Display the modified XML..." );
   Console::WriteLine( doc->OuterXml );
}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<items/>");

    //Create a document fragment.
    XmlDocumentFragment docFrag = doc.CreateDocumentFragment();

    //Set the contents of the document fragment.
    docFrag.InnerXml ="<item>widget</item>";

   //Add the children of the document fragment to the
   //original document.
   doc.DocumentElement.AppendChild(docFrag);

   Console.WriteLine("Display the modified XML...");
   Console.WriteLine(doc.OuterXml);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.LoadXml("<items/>")
        
        'Create a document fragment.
        Dim docFrag As XmlDocumentFragment = doc.CreateDocumentFragment()
        
        'Set the contents of the document fragment.
        docFrag.InnerXml = "<item>widget</item>"
        
        'Add the children of the document fragment to the
        'original document.
        doc.DocumentElement.AppendChild(docFrag)
        
        Console.WriteLine("Display the modified XML...")
        Console.WriteLine(doc.OuterXml)
    End Sub
End Class

Remarks

DocumentFragment nodes cannot be inserted into a document. However, you can insert children of the DocumentFragment node into a document.