Image.Save 方法

參考

定義

命名空間:: System.Drawing

組件:: System.Drawing.Common.dll

組件:: System.Drawing.dll

套件:: System.Drawing.Common v6.0.0

套件:: System.Drawing.Common v7.0.0

套件:: System.Drawing.Common v8.0.0

套件:: System.Drawing.Common v9.0.0-preview.2.24128.3

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將這個影像以指定的格式儲存至指定的資料流。

多載

Save(String, ImageCodecInfo, EncoderParameters)	使用指定的編碼器和影像編碼器參數，將此 Image 儲存至指定的檔案。
Save(Stream, ImageCodecInfo, EncoderParameters)	使用指定的編碼器和影像編碼器參數，將此影像儲存至指定的資料流。
Save(String, ImageFormat)	將這個 Image 以指定的格式儲存至指定的檔案。
Save(Stream, ImageFormat)	將這個影像以指定的格式儲存至指定的資料流。
Save(String)	儲存這個 Image 至指定的檔案或資料流。

Save(String, ImageCodecInfo, EncoderParameters)

來源:: Image.cs

來源:: Image.cs

來源:: Image.cs

使用指定的編碼器和影像編碼器參數，將此 Image 儲存至指定的檔案。

public:
 void Save(System::String ^ filename, System::Drawing::Imaging::ImageCodecInfo ^ encoder, System::Drawing::Imaging::EncoderParameters ^ encoderParams);

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

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

member this.Save : string * System.Drawing.Imaging.ImageCodecInfo * System.Drawing.Imaging.EncoderParameters -> unit

Public Sub Save (filename As String, encoder As ImageCodecInfo, encoderParams As EncoderParameters)

參數

filename: String

字串，包含要儲存這個 Image 之目的檔案的名稱。

encoder: ImageCodecInfo

這個 ImageCodecInfo 的 Image。

encoderParams: EncoderParameters

要用於這個 EncoderParameters 的 Image。

例外狀況

ArgumentNullException

filename 或 encoder 為 null。

ExternalException

使用了錯誤的影像格式儲存影像。

-或-

影像已儲存至建立它時所使用的檔案中。

範例

下列範例會 Bitmap 從 BMP 檔案建立物件。程序代碼會將位圖儲存到三個 JPEG 檔案，每個檔案都有不同的品質層級。

#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Drawing::Imaging;
static ImageCodecInfo^ GetEncoderInfo( ImageFormat^ format );
int main()
{
   Bitmap^ myBitmap;
   ImageCodecInfo^ myImageCodecInfo;
   Encoder^ myEncoder;
   EncoderParameter^ myEncoderParameter;
   EncoderParameters^ myEncoderParameters;
   
   // Create a Bitmap object based on a BMP file.
   myBitmap = gcnew Bitmap( "Shapes.bmp" );
   
   // Get an ImageCodecInfo object that represents the JPEG codec.
   myImageCodecInfo = GetEncoderInfo( ImageFormat->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 = gcnew EncoderParameters( 1 );
   
   // Save the bitmap as a JPEG file with quality level 25.
   myEncoderParameter = gcnew EncoderParameter( myEncoder,__int64(25) );
   myEncoderParameters->Param[ 0 ] = myEncoderParameter;
   myBitmap->Save( "Shapes025.jpg", myImageCodecInfo, myEncoderParameters );
   
   // Save the bitmap as a JPEG file with quality level 50.
   myEncoderParameter = gcnew EncoderParameter( myEncoder,__int64(50) );
   myEncoderParameters->Param[ 0 ] = myEncoderParameter;
   myBitmap->Save( "Shapes050.jpg", myImageCodecInfo, myEncoderParameters );
   
   // Save the bitmap as a JPEG file with quality level 75.
   myEncoderParameter = gcnew EncoderParameter( myEncoder,__int64(75) );
   myEncoderParameters->Param[ 0 ] = myEncoderParameter;
   myBitmap->Save( "Shapes075.jpg", myImageCodecInfo, myEncoderParameters );
}

static ImageCodecInfo^ GetEncoderInfo( ImageFormat^ format )
{
   int j;
   array<ImageCodecInfo^>^encoders;
   encoders = ImageCodecInfo::GetImageEncoders();
   for ( j = 0; j < encoders->Length; ++j )
   {
      if ( encoders[ j ]->FormatID == format->Guid)
            return encoders[ j ];

   }
   return nullptr;
}

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

Imports System.Drawing
Imports System.Drawing.Imaging


Class Example_SetJPEGQuality

    Public Shared Sub Main()
        Dim myBitmap As Bitmap
        Dim myImageCodecInfo As ImageCodecInfo
        Dim myEncoder As Encoder
        Dim myEncoderParameter As EncoderParameter
        Dim myEncoderParameters As EncoderParameters

        ' 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(ImageFormat.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, CType(25L, Int32))
        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, CType(50L, Int32))
        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, CType(75L, Int32))
        myEncoderParameters.Param(0) = myEncoderParameter
        myBitmap.Save("Shapes075.jpg", myImageCodecInfo, myEncoderParameters)

    End Sub

    Private Shared Function GetEncoderInfo(ByVal format As ImageFormat) As ImageCodecInfo
        Dim j As Integer
        Dim encoders() As ImageCodecInfo
        encoders = ImageCodecInfo.GetImageEncoders()

        j = 0
        While j < encoders.Length
            If encoders(j).FormatID = format.Guid Then
                Return encoders(j)
            End If
            j += 1
        End While
        Return Nothing

    End Function 'GetEncoderInfo
End Class

備註

不允許將映像儲存至建構來源的相同檔案，並擲回例外狀況。

另請參閱

作法：設定 JPEG 壓縮層級

適用於

Save(Stream, ImageCodecInfo, EncoderParameters)

來源:: Image.cs

來源:: Image.cs

來源:: Image.cs

使用指定的編碼器和影像編碼器參數，將此影像儲存至指定的資料流。

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

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

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

member this.Save : System.IO.Stream * System.Drawing.Imaging.ImageCodecInfo * System.Drawing.Imaging.EncoderParameters -> unit

Public Sub Save (stream As Stream, encoder As ImageCodecInfo, encoderParams As EncoderParameters)

參數

stream: Stream

Stream，其中將會儲存影像。

encoder: ImageCodecInfo

這個 ImageCodecInfo 的 Image。

encoderParams: EncoderParameters

EncoderParameters，指定由影像編碼器使用的參數。

例外狀況

ArgumentNullException

stream 為 null。

ExternalException

使用了錯誤的影像格式儲存影像。

備註

請勿將映像儲存至用來建構映像的相同數據流。這樣做可能會損毀數據流。

影像必須儲存至數據流，位移為零。如果在儲存影像之前已將任何其他數據寫入數據流，則數據流中的影像數據將會損毀。

適用於

Save(String, ImageFormat)

來源:: Image.cs

來源:: Image.cs

來源:: Image.cs

將這個 Image 以指定的格式儲存至指定的檔案。

public:
 void Save(System::String ^ filename, System::Drawing::Imaging::ImageFormat ^ format);

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

member this.Save : string * System.Drawing.Imaging.ImageFormat -> unit

Public Sub Save (filename As String, format As ImageFormat)

參數

filename: String

字串，包含要儲存這個 Image 之目的檔案的名稱。

format: ImageFormat

這個 ImageFormat 的 Image。

例外狀況

ArgumentNullException

filename 或 format 為 null。

ExternalException

使用了錯誤的影像格式儲存影像。

-或-

影像已儲存至建立它時所使用的檔案中。

範例

下列程式代碼範例示範如何從類型建構位圖，以及如何使用 Save 方法。若要執行此範例，請將程式代碼貼到 Windows Form 中。處理表單 Paint 的事件，並呼叫 ConstructFromResourceSaveAsGif 方法，傳遞 e 為 PaintEventArgs

private:
    void ConstructFromResourceSaveAsGif(PaintEventArgs^ e)
    {
        // Construct a bitmap from the button image resource.
        Bitmap^ bmp1 = gcnew Bitmap(Button::typeid, "Button.bmp");
        String^ savePath =  
            Environment::GetEnvironmentVariable("TEMP") + "\\Button.bmp";

        try
        {
            // Save the image as a GIF.
            bmp1->Save(savePath, System::Drawing::Imaging::ImageFormat::Gif);
        }
        catch (IOException^)
        {
            // Carry on regardless
        }

        // Construct a new image from the GIF file.
        Bitmap^ bmp2 = nullptr;
        if (File::Exists(savePath))
        {
            bmp2 = gcnew Bitmap(savePath);
        }

        // Draw the two images.
        e->Graphics->DrawImage(bmp1, Point(10, 10));

        // If bmp1 did not save to disk, bmp2 may be null
        if (bmp2 != nullptr)
        {
            e->Graphics->DrawImage(bmp2, Point(10, 40));
        }

        // Dispose of the image files.
        delete bmp1;
        if (bmp2 != nullptr)
        {
            delete bmp2;
        }
    }

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

Private Sub ConstructFromResourceSaveAsGif(ByVal e As PaintEventArgs)

    ' Construct a bitmap from the button image resource.
    Dim bmp1 As New Bitmap(GetType(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.
    Dim bmp2 As 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()
End Sub

適用於

Save(Stream, ImageFormat)

來源:: Image.cs

來源:: Image.cs

來源:: Image.cs

將這個影像以指定的格式儲存至指定的資料流。

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

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

member this.Save : System.IO.Stream * System.Drawing.Imaging.ImageFormat -> unit

Public Sub Save (stream As Stream, format As ImageFormat)

參數

stream: Stream

Stream，其中將會儲存影像。

format: ImageFormat

ImageFormat，指定儲存之影像的格式。

例外狀況

ArgumentNullException

stream 或 format 為 null。

ExternalException

使用了錯誤的影像格式儲存影像。

備註

您應該避免將映像儲存至用來建構影像的相同數據流。這樣做可能會損毀數據流。

影像必須儲存至數據流，位移為零。如果在儲存影像之前已將任何其他數據寫入數據流，則數據流中的影像數據將會損毀。

適用於

Save(String)

來源:: Image.cs

來源:: Image.cs

來源:: Image.cs

儲存這個 Image 至指定的檔案或資料流。

public:
 void Save(System::String ^ filename);

public void Save (string filename);

member this.Save : string -> unit

Public Sub Save (filename As String)

參數

filename: String

字串，包含要儲存這個 Image 之目的檔案的名稱。

例外狀況

ArgumentNullException

filename 為 null。

ExternalException

使用了錯誤的影像格式儲存影像。

-或-

影像已儲存至建立它時所使用的檔案中。

範例

下列程式代碼範例示範如何呼叫 Save 方法。此範例的設計目的是要與 Windows Forms 搭配使用。 Create 表單，其中包含名為Button5的按鈕。將程式代碼貼到表單中，並將方法與按鈕的事件 Click 產生關聯。

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

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.");
    }
}

Private Sub Button5_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button5.Click
    Try
        If (image1 IsNot Nothing) Then
            image1.Save("c:\myBitmap.bmp")
            Button5.Text = "Saved file."
        End If
    Catch ex As Exception
        MessageBox.Show("There was a problem saving the file." _
        & "Check the file permissions.")
    End Try

End Sub

備註

如果影像的檔格式沒有任何編碼器存在，則會使用可攜式網路圖形 (PNG) 編碼器。當您使用 Save 方法將圖形影像儲存為 Windows Metafile Format (WMF) 或增強元檔格式 (EMF) 檔案時，產生的檔案會儲存為可攜式網路圖形 (PNG) 檔案。發生此行為的原因是 .NET Framework 的 GDI+ 元件沒有編碼器，可用來將檔案儲存為 .wmf 或.emf檔案。

不允許將映像儲存至建構來源的相同檔案，並擲回例外狀況。

適用於

共用方式為

Image.Save 方法

定義

多載

Save(String, ImageCodecInfo, EncoderParameters)

參數

例外狀況

範例

備註

另請參閱

適用於

Save(Stream, ImageCodecInfo, EncoderParameters)

參數

例外狀況

備註

適用於

Save(String, ImageFormat)

參數

例外狀況

範例

適用於

Save(Stream, ImageFormat)

參數

例外狀況

備註

適用於

Save(String)

參數

例外狀況

範例

備註

適用於

其他資源