The DICOM format is not designed for an easy insertion of pages. The following issues exist:

• Pages are stored sequentially rather than in arbitrary order. If the image is compressed, replacing a page requires rewriting all subsequent pages.
• "Number of pages" tag is stored as "Integer string". If, for example, tag is equal to "99", adding a page requires to increase length of this tag, and thus requires rewriting of the whole image.
• All pages in the file must have the same dimensions and compression.
• Some DICOM modalities support multiframe images, while others don't.

According to the above issues, DICOM format filter in ImageGear .NET has the following limitations:

• Only APPEND and OVERWRITE saving modes are supported.
• ImageGear .NET allows appending a page to a DICOM file only if the file already has "Number Of Pages" tag, and this tag has maximum possible length for an Integer String: 12 bytes.
• Page being saved must have the same dimensions and compression as existing pages in the file.
• ImageGear does not check if image's modality allows multipage images.

If any of the limitations is encountered, ImageGear throws an exception.

To save a multipage image:

1. Load an image to ImageGear .NET.
2. Save image to a new file (or use OVERWRITE mode).
3. Load next image to ImageGear .NET.
4. Save image to existing file, using APPEND mode.
5. Repeat steps 3 and 4 for all pages to be written.

Alternatively, create an ImGearDocument Class and save to DICOM using the SaveDocument Method.