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

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

Сохраняет синхронно все изображения из этой коллекции в указанный поток, используя указанный EncoderBase.

Синтаксис

'Declaration

Public Overloads Sub SaveSync( _
   ByVal streamПоток, в котором должна быть сохранена коллекция изображений.
 As System.IO.Stream, _
   ByVal encoderКодировщик для сохранения изображений.
 As Vintasoft.Imaging.Codecs.Encoders.EncoderBase _
)

public void SaveSync(
   System.IO.Stream stream, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase encoder
)

public: void SaveSync(
   System.IO.Stream* stream, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase* encoder
)

public:
void SaveSync(
   System.IO.Stream^ stream, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase^ encoder
)

Parameters

stream: Поток, в котором должна быть сохранена коллекция изображений.
encoder: Кодировщик для сохранения изображений.

Исключения

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

Ремарки

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

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

Этот метод

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

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

Этот метод

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

если

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

Этот метод

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

если

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

Этот метод

изменяет изображения в исходном потоке, если некоторые изображения исходного файла изменяются в коллекции изображений
удаляет изображения из исходного потока, если некоторые изображения исходного файла удаляются из коллекции изображений
добавляет изображения в исходный поток, если некоторые изображения НЕ из исходного файла добавляются в коллекцию изображений
переиндексирует изображения в исходный поток, если изображения переиндексированы в коллекции изображений
процесс сохранения не может быть отменен, сохранение изображений не может быть подавлено
источники изображений в коллекции изображений изменены, т. е. images[i].SourceInfo.Stream изменяется на stream

если

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

Этот метод

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

если

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

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

Пример

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

VB.NET


' open a stream
Dim stream As New System.IO.FileStream("new-file-name.tif", System.IO.FileMode.OpenOrCreate, System.IO.FileAccess.ReadWrite)
' create an encoder
Using encoder As New Vintasoft.Imaging.Codecs.Encoders.TiffEncoder()
    ' specify that image collection should be switched to a stream
    encoder.SaveAndSwitchSource = True
    ' save image collection to a TIFF file
    imageViewer1.Images.SaveSync(stream, encoder)
    ' close a stream
    stream.Close()
End Using


// open a stream
System.IO.FileStream stream = new System.IO.FileStream(
    "new-file-name.tif", 
    System.IO.FileMode.OpenOrCreate, 
    System.IO.FileAccess.ReadWrite);
// 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 stream
    encoder.SaveAndSwitchSource = true;
    // save image collection to a TIFF file
    imageViewer1.Images.SaveSync(stream, encoder);
    // close a stream
    stream.Close();
}

Требования

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

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