Image.Save Method (Stream, ImageCodecInfo, EncoderParameters)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Saves this image to the specified stream, with the specified encoder and image encoder parameters.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public void Save(
	Stream stream,
	ImageCodecInfo encoder,
	EncoderParameters encoderParams


Type: System.IO.Stream

The Stream where the image will be saved.

Type: System.Drawing.Imaging.ImageCodecInfo

The ImageCodecInfo for this Image.

Type: System.Drawing.Imaging.EncoderParameters

An EncoderParameters that specifies parameters used by the image encoder.

Exception Condition

stream is null.


The image was saved with the wrong image format.

Do not save an image to the same stream that was used to construct the image. Doing so might damage the stream.

The image must be saved to the stream at an offset of zero. If any additional data has been written to the stream before saving the image, the image data in the stream will be corrupted.

.NET Framework
Available since 1.1
Return to top