Skip to main content
All docs
V25.1
  • DevExpress v25.1 Update — Your Feedback Matters

    Our What's New in v25.1 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

    Take the survey Not interested

    ICustomXmlPart Interface

    In This Article

    A custom XML part embedded in a document.

    Namespace: DevExpress.XtraRichEdit.API.Native

    Assembly: DevExpress.RichEdit.v25.1.Core.dll

    NuGet Package: DevExpress.RichEdit.Core

    #Declaration

    public interface ICustomXmlPart :
        OfficeCustomXmlPart<ICustomXmlPart>,
        OfficeCustomXmlPart

    #Remarks

    You can embed arbitrary XML data (called custom XML parts) in documents in DOCX and DOC format. Custom XML parts are included in the document structure but are not visible in the document.

    The image below shows the structure of a DOCX file with three custom XML parts (item1, item2, and item3).

    Document_CustomXmlParts

    A custom XML part is an object that exposes the ICustomXmlPart interface. Use the Document.CustomXmlParts property to access the CustomXmlPartCollection collection that stores custom XML parts.

    You can use a custom XML part’s index to obtain it from the collection. Use the CustomXmlPartDocument property to access an XML document associated with the ICustomXmlPart object.

    using DevExpress.XtraRichEdit;
    using DevExpress.XtraRichEdit.API.Native;
    using System.Xml;
    // ...
    
    using (RichEditDocumentServer wordProcessor = new RichEditDocumentServer())
    {
        Document document = wordProcessor.Document;
        // Load a document.
        document.LoadDocument("Documents\\CustomXmlParts.docx");
        // Access a custom XML file stored in the document.
        XmlDocument xmlDoc = document.CustomXmlParts[0].CustomXmlPartDocument;
        // Retrieve employee names from the XML file and display them in the document.
        XmlNodeList nameList = xmlDoc.GetElementsByTagName("Name");
        document.AppendText("Employee list:");
        foreach (XmlNode name in nameList)
        {
            document.AppendText("\r\n \u00B7 " + name.InnerText);
        }
    }
    
    See Also