'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

Кодировщик для сохранения изображений.

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

Поддерживаемые форматы изображений: 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

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

' 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 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Справочник

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

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