Merging images is required in many templates: Company logos in invoices, pictures of employees in HR reports or signature images in letters. These images can't be part of the template as they have to be merged dynamically.

With the release of TX Text Control .NET Server 16.0, the MailMerge class comes with this feature out of the box. It is possible to pass an image path with the merge data or an image can be added dynamically in the new ImageFieldMerged event.

Image fields are regular merge fields with a special format:

TX Text Control image field format

'image:' is the identifier followed by the name of this field. In this sample, all image fields are merged with the same image in the ImageFieldMerged event:

void mailMerge_ImageFieldMerged(object sender,
    TXTextControl.DocumentServer.MailMerge.ImageFieldMergedEventArgs e)
{
    if (pictureBox1.Image == null)
        return;

    // add the image from the PictureBox
    TXTextControl.Image img = new TXTextControl.Image(pictureBox1.Image);
    e.Image = img;
}

Download the new sample in our source code library that shows this new feature in detail:

How to merge images into MS Word templates