Replaces placeholder variables by plain WordML code.


Element definition

This element (avalaible for the seasoned xmldocx user) allows the direct substitution of placeholder variables by WordML code.

Only use this element if you really understand the OOXML standard. xmldocx does not validate the WordML against any scheme so you have to make sure by your own that the WordML is correctly encoded. Moreover, this element does not take care by its own of internal/external relationships included in the WordML code.

Attributes and sub-elements


The names of the placeholder template variables and the WordFragment instances that should replace them as values.


key Description
firstMatch If the variable appears more than once within the Word document and firstMatch is set to true, xmldocx will only replace the first ocurrence of the variable within the Word document.
target Possible values are: document. This option sets the scope of the replacement procedure.
replaceType Possible values are:
  • block (default): replaces the variable and removes its containing paragraph,
  • inline: only replaces the variable by the WordFragment inline content (it may be used to replace a variable by formatted text).
Code samples
#Example 1




The resulting Word document looks like: