Home Library Learn Downloads Support Community
Sign in | United States - English | |
1 out of 2 rated this helpful - Rate this topic

Image.Save Method (Stream, ImageFormat)

.NET Framework 4

Saves this image to the specified stream in the specified format.

Namespace:  System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)
C#
C++
F#
VB
Copy 
public void Save(
	Stream stream,
	ImageFormat format
)

Parameters

stream
Type: System.IO.Stream
The Stream where the image will be saved.
format
Type: System.Drawing.Imaging.ImageFormat
An ImageFormat that specifies the format of the saved image.
Exception Condition
ArgumentNullException

stream or format is null.
ExternalException

The image was saved with the wrong image format

You should avoid saving an image to the same stream that was used to construct it. 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

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Icon not supported
If you are wondering why you can't use this method with ImageFormat.Icon, it is because there are no encoders for that format.

A method for encoding icons has been created and can be seen here: http://www.codeproject.com/KB/GDI-plus/safeicon.aspx
History