Image.Save 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

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

重载

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

Save(String, ImageCodecInfo, EncoderParameters)

Source:

Image.cs

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

C#

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 文件中，每个文件具有不同的质量级别。

C#

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;
    }
}

注解

不允许将映像保存到从中构造的同一个文件，并引发异常。

另请参阅

• 如何：设置 JPEG 压缩级别

Save(Stream, ImageCodecInfo, EncoderParameters)

Source:

Image.cs

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

C#

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)

Source:

Image.cs

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

C#

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

C#

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)

Source:

Image.cs

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

C#

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)

Source:

Image.cs

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

C#

public void Save (string filename);

参数

filename

String

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

例外

ArgumentNullException

filename 为 null。

ExternalException

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

- 或 -

该图像被保存到创建该图像的文件。

示例

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

C#

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文件的编码器。

不允许将映像保存到从中构造的同一个文件，并引发异常。