SaveSync(String,EncoderBase) Метод (ImageCollection)

В этом разделе

Сохраняет синхронно все изображения из этой коллекции в указанный файл многостраничного изображения (JBIG2/PDF/TIFF) с помощью указанный EncoderBase.

Синтаксис

Visual Basic
C#
Управляемые расширения для C++
C++/CLI

'Declaration

Public Overloads Sub SaveSync( _
   ByVal filenameИмя файла, в котором должна быть сохранена коллекция изображений.
 As System.String, _
   ByVal encoderКодировщик для сохранения изображений.
 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: Имя файла, в котором должна быть сохранена коллекция изображений.
encoder: Кодировщик для сохранения изображений.

Исключения

Исключение	Описание
System.ArgumentNullException	Выбрасывается, если filename равен null.
System.InvalidOperationException	Выбрасывается, если коллекция изображений не содержит изображений -или-, в данный момент выполняется другой процесс сохранения.
EncoderException	Выбрасывается, если при сохранении изображения произошла ошибка.

Ремарки

Этот метод работает синхронно.

Поддерживаемые форматы изображений: JBIG2, PDF, TIFF.

Этот метод

сохраняет изображения в указанный новый файл изображения. по filename с помощью encoder
файл, указанный в filename, перезаписывается, если он существует.
процесс сохранения можно отменить, сохранение изображений можно запретить.
Источники изображений в коллекции изображений не изменяются, т. е. images[i].SourceInfo.Filename не изменяется

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource имеет значение false
encoder. CreateNewFile имеет значение true

Этот метод

добавляет изображения в существующий файл изображения, указанный filename, с помощью encoder
процесс сохранения может быть отменено, сохранение изображений можно запретить.
Источники изображений в коллекции изображений не изменяются, т.е. images[i].SourceInfo.Filename не изменяется

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

Этот метод

сохраняет изображения в новый файл JBIG2/PDF/TIFF, указанный filename, с помощью encoder
указанный файл по filename перезаписывается, если он существует.
процесс сохранения нельзя отменить,сохранение изображений невозможно запретить.
Изменены источники изображений в коллекции изображений, т. е. images[i].SourceInfo.Filename изменено на filename

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource имеет значение true

Этот метод

меняет изображения в исходном JBIG2/PDF/ TIFF, если некоторые изображения исходного файла изменены в коллекции изображений.
удаляет изображения из исходного файла JBIG2/PDF/TIFF, если некоторые изображения исходного файла удалены из коллекции изображений.
добавляет изображения в исходный файл JBIG2/PDF/TIFF, если в коллекцию изображений добавлены некоторые изображения NOT из исходного файла.
переиндексирует изображения в исходном файле JBIG2/PDF/TIFF, если изображения переиндексированы в коллекция изображений
процесс сохранения не может быть отменен, сохранение изображений не может быть подавлено
изменяются источники изображений в коллекции изображений, т.е. images[i].SourceInfo.Filename изменяется на filename

, если

filename == images[0]..SourceInfo.Filename
SaveAndSwitchSource имеет значение true

Это метод

выдать исключение

filename == images[0]..SourceInfo. Имя файла
SaveAndSwitchSource - false

Событие ImageSaving произойдет перед сохранением каждого изображения. В этом событии вы можете получить информацию об изображении, запретить сохранение изображения или отменить процесс сохранения изображения. Событие ImageSaved произойдет после сохранения каждого изображения. В этом событии вы можете получить информацию о ходе процесса сохранения изображений или отменить процесс сохранения изображений.

Пример

Этот пример иллюстрирует, как синхронно сохранить коллекцию изображений.

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);
}

Требования

Целевые платформы: .NET 9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Смотрите также

Справочник

ImageCollection Class
Члены типа ImageCollection

SaveAndSwitchSource
DocumentConverter
Список перегрузок

Отправить отзыв