Image.Save Method (String, ImageFormat)
Saves this Image to the specified file in the specified format.
Namespace: System.Drawing
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- filename
- Type: System.String
A string that contains the name of the file to which to save this Image.
- format
- Type: System.Drawing.Imaging.ImageFormat
The ImageFormat for this Image.
| Exception | Condition |
|---|---|
| ArgumentNullException | filename or format is null. |
| ExternalException | The image was saved with the wrong image format. -or- The image was saved to the same file it was created from. |
The following code example demonstrates how to construct a bitmap from a type, and how to use the Save method. To run this example, paste the code into a Windows Form. Handle the form’s Paint event, and call the ConstructFromResourceSaveAsGif method, passing e as PaintEventArgs
private void ConstructFromResourceSaveAsGif(PaintEventArgs e) { // Construct a bitmap from the button image resource. Bitmap bmp1 = new Bitmap(typeof(Button), "Button.bmp"); // Save the image as a GIF. bmp1.Save("c:\\button.gif", System.Drawing.Imaging.ImageFormat.Gif); // Construct a new image from the GIF file. Bitmap bmp2 = new Bitmap("c:\\button.gif"); // Draw the two images. e.Graphics.DrawImage(bmp1, new Point(10, 10)); e.Graphics.DrawImage(bmp2, new Point(10, 40)); // Dispose of the image files. bmp1.Dispose(); bmp2.Dispose(); }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
