Image.Save 方法

Namespace:System.Drawing
Assembly:System.Drawing.dll

将此图像以指定的格式保存到指定的流中。

重载

方法名称	说明
`Save(String, ImageCodecInfo, EncoderParameters)`	使用指定的编码器和图像编码器参数，将该 `Image` 保存到指定的文件。
`Save(Stream, ImageCodecInfo, EncoderParameters)`	使用指定的编码器和图像编码器参数，将该图像保存到指定的流。
`Save(String, ImageFormat)`	将此 `Image` 以指定格式保存到指定文件。
`Save(Stream, ImageFormat)`	将此图像以指定的格式保存到指定的流中。
`Save(String)`	将该 `Image` 保存到指定的文件或流。

`Save(String, ImageCodecInfo, EncoderParameters)`

使用指定的编码器和图像编码器参数，将该 Image 保存到指定的文件。

public void Save (string filename, System.Drawing.Imaging.ImageCodecInfo encoder, System.Drawing.Imaging.EncoderParameters encoderParams);

参数

filename String
字符串，包含要将此 Image 保存到的文件的名称。

encoder ImageCodecInfo
用于此 ImageCodecInfo 的 Image。

encoderParams EncoderParameters
用于该 EncoderParameters 的 Image。

异常

ArgumentNullException

filename 或 encoder 为 null.

ExternalException

该图像以错误的图像格式保存。
- 或 -
该图像被保存到创建该图像的文件。

示例

下面的示例从 BMP 文件创建一个 Bitmap 对象。该代码将位图保存为三个 JPEG 文件，每个文件都有不同的质量级别。

using System;
using System.Drawing;
using System.Drawing.Imaging;
class Example_SetJPEGQuality
{public static void Main(){Bitmap myBitmap;ImageCodecInfo myImageCodecInfo;Encoder myEncoder;EncoderParameter myEncoderParameter;EncoderParameters myEncoderParameters;// Create a Bitmap object based on a BMP file.myBitmap = new Bitmap("Shapes.bmp");// Get an ImageCodecInfo object that represents the JPEG codec.myImageCodecInfo = GetEncoderInfo("image/jpeg");// Create an Encoder object based on the GUID// for the Quality parameter category.myEncoder = Encoder.Quality;// Create an EncoderParameters object.// An EncoderParameters object has an array of EncoderParameter// objects. In this case, there is only one// EncoderParameter object in the array.myEncoderParameters = new EncoderParameters(1);// Save the bitmap as a JPEG file with quality level 25.myEncoderParameter = new EncoderParameter(myEncoder, 25L);myEncoderParameters.Param[0] = myEncoderParameter;myBitmap.Save("Shapes025.jpg", myImageCodecInfo, myEncoderParameters);// Save the bitmap as a JPEG file with quality level 50.myEncoderParameter = new EncoderParameter(myEncoder, 50L);myEncoderParameters.Param[0] = myEncoderParameter;myBitmap.Save("Shapes050.jpg", myImageCodecInfo, myEncoderParameters);// Save the bitmap as a JPEG file with quality level 75.myEncoderParameter = new EncoderParameter(myEncoder, 75L);myEncoderParameters.Param[0] = myEncoderParameter;myBitmap.Save("Shapes075.jpg", myImageCodecInfo, myEncoderParameters);}private static ImageCodecInfo GetEncoderInfo(String mimeType){int j;ImageCodecInfo[] encoders;encoders = ImageCodecInfo.GetImageEncoders();for(j = 0; j < encoders.Length; ++j){if(encoders[j].MimeType == mimeType)return encoders[j];}return null;}
}

备注

不允许将图像保存到从中构建它的文件，并且会引发异常。

`Save(Stream, ImageCodecInfo, EncoderParameters)`

使用指定的编码器和图像编码器参数，将该图像保存到指定的流。

public void Save (System.IO.Stream stream, System.Drawing.Imaging.ImageCodecInfo encoder, System.Drawing.Imaging.EncoderParameters encoderParams);

参数

stream Stream
将在其中保存图像的 Stream。

encoder ImageCodecInfo
用于此 ImageCodecInfo 的 Image。

encoderParams EncoderParameters
一个 EncoderParameters，它指定图像编码器使用的参数。

异常

ArgumentNullException
stream 为 null。

ExternalException
该图像以错误的图像格式保存。

备注

不要将图像保存到用于构造映像的相同流中。这样做可能会损坏流。
必须将该图像保存到流中偏移量为零的位置。如果在保存映像之前已向流中写入任何其他数据，则流中的图像数据将损坏。

`Save(String, ImageFormat)`

将此 Image 以指定格式保存到指定文件。

public void Save (string filename, System.Drawing.Imaging.ImageFormat format);

参数

filename String
字符串，包含要将此 Image 保存到的文件的名称。

format ImageFormat
用于此 ImageFormat 的 Image。

异常

ArgumentNullException
filename 或 format 为 null.

ExternalException
该图像以错误的图像格式保存。
- 或 -
该图像被保存到创建该图像的文件。

示例

下面的代码示例演示如何从类型构造位图，以及如何使用 Save 方法。若要运行此示例，请将代码粘贴到 Windows 窗体中。处理窗体的 Paint 事件，并调用 ConstructFromResourceSaveAsGif 方法，并将 e 作为 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();
}

`Save(Stream, ImageFormat)`

将此图像以指定的格式保存到指定的流中。

public void Save (System.IO.Stream stream, System.Drawing.Imaging.ImageFormat format);

参数

stream Stream
将在其中保存图像的 Stream。

format ImageFormat
ImageFormat，指定保存的图像的格式。

异常

ArgumentNullException
stream 或 format 为 null。

ExternalException
该图像以错误的图像格式保存

备注

应避免将图像保存到用于构造它的同一个流中。这样做可能会损坏流。
必须将该图像保存到流中偏移量为零的位置。如果在保存映像之前已向流中写入任何其他数据，则流中的图像数据将损坏。

`Save(String)`

将该 Image 保存到指定的文件或流。

public void Save (string filename);

参数

filename String
字符串，包含要将此 Image 保存到的文件的名称。

异常

ArgumentNullException
filename 是 null.

ExternalException
该图像以错误的图像格式保存。
- 或 -
该图像被保存到创建该图像的文件。

示例

下面的代码示例演示如何调用 Save 方法。此示例旨在与 Windows 窗体一起使用。创建一个包含名为 Button5的按钮的窗体。将代码粘贴到窗体中，并将该方法与按钮的 Click 事件相关联。

private void Button5_Click(System.Object sender, System.EventArgs e)
{try{if (image1 != null){image1.Save("c:\\myBitmap.bmp");Button5.Text = "Saved file.";}}catch(Exception){MessageBox.Show("There was a problem saving the file." +"Check the file permissions.");}
}

备注

如果图像的文件格式不存在编码器，则使用可移植网络图形（PNG）编码器。当使用 Save 方法将图形图像保存为 Windows 图元文件格式（WMF）或增强型图元文件格式（EMF）文件时，生成的文件将另存为可移植网络图形（PNG）文件。出现此行为是因为 .NET Framework 的 GDI+ 组件没有可用于将文件另存为 .wmf 或 .emf 文件的编码器。

不允许将图像保存到从中构建它的文件，并且会引发异常。