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

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

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

Синтаксис

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

'Declaration

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

public void SaveSync(
   System.String filename, 
   bool createNewFile
)

public: void SaveSync(
   System.String filename, 
   bool createNewFile
)

public:
void SaveSync(
   System.String filename, 
   bool createNewFile
)

Parameters

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

Исключения

Исключение	Описание
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
процесс сохранения можно отменить, сохранение изображений можно отменить
источники изображений в коллекции изображений не изменяются, т. е. images[i].SourceInfo.Filename не изменяется

если

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

Этот метод

сохраняет изображения в новый файл 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
' file will be overwritten if it exists
imageViewer1.Images.SaveSync("new-file-name.tif", True)


// save image collection to a TIFF file
// file will be overwritten if it exists
imageViewer1.Images.SaveSync("new-file-name.tif", true);

Требования

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

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