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

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

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

Синтаксис

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

'Declaration

Public Overloads Sub SaveSync( _
   ByVal filenameИмя файла, в котором должна быть сохранена коллекция изображений.
 As System.String _
)

public void SaveSync(
   System.String filename
)

public: void SaveSync(
   System.String filename
)

public:
void SaveSync(
   System.String filename
)

Parameters

filename: Имя файла, в котором должна быть сохранена коллекция изображений.

Исключения

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

Ремарки

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

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

Подходящий кодировщик выбирается автоматически из расширения имени файла, исключение выдается, если кодировщик не найден для расширения файла, указанного в filename.

Этот метод

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

если

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource равно false
createNewFile равно true

Этот метод

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

, если

filename != images[0]..SourceInfo.Filename
SaveAndSwitchSource равен true

Этот метод

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

, если

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

Этот метод

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

, если

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

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

Пример

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

VB.NET


' save image collection to a TIFF file
imageViewer1.Images.SaveSync("new-file-name.tif")


// save image collection to a TIFF file
imageViewer1.Images.SaveSync("new-file-name.tif");

Требования

Целевые платформы: .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
Список перегрузок

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