SaveSync(String,EncoderBase) Method (ImageCollection)

In This Topic

Saves synchronously all images from this collection to specified multipage image (JBIG2/PDF/TIFF) file using the specified EncoderBase.

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration

Public Overloads Sub SaveSync( _
   ByVal filenameFilename where the image collection should be saved.
 As System.String, _
   ByVal encoderEncoder to the save images.
 As Vintasoft.Imaging.Codecs.Encoders.EncoderBase _
)

public void SaveSync(
   System.String filename, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase encoder
)

public: void SaveSync(
   System.String filename, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase* encoder
)

public:
void SaveSync(
   System.String filename, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase^ encoder
)

Parameters

filename: Filename where the image collection should be saved.
encoder: Encoder to the save images.

Exceptions

Exception	Description
System.ArgumentNullException	Thrown if filename is null.
System.InvalidOperationException	Thrown if image collection does not contain images -or- another saving process is executing at this moment.
EncoderException	Thrown if error occurs at saving the image.

Remarks

This method works synchronously.

Supported image formats: JBIG2, PDF, TIFF.

This method

saves images to new image file specified by filename using encoder
file specified by filename is overwritten if it exists
saving process can be canceled, saving of images can be suppressed
sources of images in the image collection are not changed, i.e. images[i].SourceInfo.Filename is not changed

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource is false
encoder.CreateNewFile is true

This method

adds images to existing image file specified by filename using encoder
saving process can be canceled, saving of images can be suppressed
sources of images in the image collection are not changed, i.e. images[i].SourceInfo.Filename is not changed

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource is false
encoder.CreateNewFile is false

This method

saves images to new JBIG2/PDF/TIFF file specified by filename using encoder
file specified by filename is overwritten if it exists
saving process cannot be canceled, saving of images cannot be suppressed
sources of images in the image collection are changed, i.e. images[i].SourceInfo.Filename is changed to filename

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource is true

This method

changes images in the source JBIG2/PDF/TIFF file if some images of source file are changed in the image collection
removes images from the source JBIG2/PDF/TIFF file if some images of source file are removed from the image collection
adds images to the source JBIG2/PDF/TIFF file if some images of NOT from the source file are added to the image collection
reindex images in the source JBIG2/PDF/TIFF file if images are reindexed in the image collection
saving process cannot be canceled, saving of images cannot be suppressed
sources of images in the image collection is changed, i.e. images[i].SourceInfo.Filename is changed to filename

filename == images[0]..SourceInfo.Filename
SaveAndSwitchSource is true

This method

throw an exception

filename == images[0]..SourceInfo.Filename
SaveAndSwitchSource is false

ImageSaving event will occur before saving of each image. In this event you can get information about the image, suppress image saving or cancel image saving process.
ImageSaved event will occur after saving of each image. In this event you can get information about progress of images saving process or cancel image saving process.

Example

This example illustrates how to save the image collection synchronously.

VB.NET


' create an encoder
Using encoder As New Vintasoft.Imaging.Codecs.Encoders.TiffEncoder()
    ' specify that image collection should be switched to a file
    encoder.SaveAndSwitchSource = True
    ' save image collection to a TIFF file
    imageViewer1.Images.SaveSync("new-file-name.tif", encoder)
End Using


// create an encoder
using (Vintasoft.Imaging.Codecs.Encoders.TiffEncoder encoder =
    new Vintasoft.Imaging.Codecs.Encoders.TiffEncoder())
{
    // specify that image collection should be switched to a file
    encoder.SaveAndSwitchSource = true;
    // save image collection to a TIFF file
    imageViewer1.Images.SaveSync("new-file-name.tif", encoder);
}

Requirements

Target Platforms: .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Reference

ImageCollection Class
ImageCollection Members

SaveAndSwitchSource
DocumentConverter
Overload List

Send Feedback