XmlDocument.CreateDocumentFragment Method

Reference

Definition

Namespace:: System.Xml

Assemblies:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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.

Applies to

Jaa