Replace field/placeholder in doc with an additional doc



We want to create a complex Document based on several smal Word documents. So i think we need placeholder who are replaced the placeholder (or a field) by a complete word.docx.

How can we do that?
Would you have code examples for a similar scenario?




You can simply insert mergefields in your main document. After that you can move cursor to those mergefields and insert small-documents. You can build logic on the following code to get the desired results:

Aspose.Words.Document doc = new Aspose.Words.Document("E:\\temp\\template.docx");
DocumentBuilder builder = new DocumentBuilder(doc);

Aspose.Words.Document subDoc = new Aspose.Words.Document("E:\\temp\\in.docx");

builder.InsertDocument(subDoc, ImportFormatMode.KeepSourceFormatting);


Hope, this helps.



manny thank you! That’s easy and easy.

Another question. How can I proceed if the newly added document is to be replaced by a field (ie MergeField) or another placeholder (what is the best case?). The replacement with a string is clear, but not by a document.

thank you in advance



You can also build logic on the following code to get the desired output:

Document doc = new Document("E:\\Temp\\template.docx");
Document subDoc = new Document("E:\\Temp\\in.docx");

FindReplaceOptions options = new FindReplaceOptions();
options.ReplacingCallback = new FindAndReplace(subDoc);

doc.Range.Replace(new Regex("PLACEHOLDER"), "", options);


private class FindAndReplace : IReplacingCallback
    public Document doc = null;
    public FindAndReplace(Document _doc)
        doc = _doc;

    ReplaceAction IReplacingCallback.Replacing(ReplacingArgs e)
        // This is a Run node that contains either the beginning or the complete match.
        Node currentNode = e.MatchNode;

        // The first (and may be the only) run can contain text before the match,
        // in this case it is necessary to split the run.
        if (e.MatchOffset > 0)
            currentNode = SplitRun((Run)currentNode, e.MatchOffset);

        // This array is used to store all nodes of the match for further removing.
        ArrayList runs = new ArrayList();

        // Find all runs that contain parts of the match string.
        int remainingLength = e.Match.Value.Length;
        while (
            (remainingLength > 0) &&
            (currentNode != null) &&
            (currentNode.GetText().Length <= remainingLength))
            remainingLength = remainingLength - currentNode.GetText().Length;

            // Select the next Run node.
            // Have to loop because there could be other nodes such as BookmarkStart etc.
                currentNode = currentNode.NextSibling;
            while ((currentNode != null) && (currentNode.NodeType != NodeType.Run));

        // Split the last run that contains the match if there is any text left.
        if ((currentNode != null) && (remainingLength > 0))
            SplitRun((Run)currentNode, remainingLength);

        DocumentBuilder builder = new DocumentBuilder((Document)e.MatchNode.Document);

        builder.InsertDocument(doc, ImportFormatMode.KeepSourceFormatting);

        foreach (Run run in runs)

        return ReplaceAction.Skip;

    private static Run SplitRun(Run run, int position)
        Run afterRun = (Run)run.Clone(true);
        afterRun.Text = run.Text.Substring(position);
        run.Text = run.Text.Substring((0), (0) + (position));
        run.ParentNode.InsertAfter(afterRun, run);
        return afterRun;