Bagikan melalui

Image.Save Metode

  • Referensi

Definisi

Ruang nama:
System.Drawing
Rakitan:
System.Drawing.Common.dll
Rakitan:
System.Drawing.dll
Paket:
System.Drawing.Common v6.0.0
Paket:
System.Drawing.Common v7.0.0
Paket:
System.Drawing.Common v8.0.0
Paket:
System.Drawing.Common v9.0.0-preview.2.24128.3

Menyimpan gambar ini ke aliran yang ditentukan dalam format yang ditentukan.

Overload

Save(String, ImageCodecInfo, EncoderParameters)

Menyimpan ini Image ke file yang ditentukan, dengan parameter encoder dan image-encoder yang ditentukan.
Save(Stream, ImageCodecInfo, EncoderParameters)

Menyimpan gambar ini ke aliran yang ditentukan, dengan parameter encoder dan encoder gambar yang ditentukan.
Save(String, ImageFormat)

Simpan ini Image ke file yang ditentukan dalam format yang ditentukan.
Save(Stream, ImageFormat)

Menyimpan gambar ini ke aliran yang ditentukan dalam format yang ditentukan.
Save(String)

Menyimpan ini Image ke file atau aliran yang ditentukan.

Save(String, ImageCodecInfo, EncoderParameters)

Sumber:
Image.cs
Sumber:
Image.cs
Sumber:
Image.cs

Menyimpan ini Image ke file yang ditentukan, dengan parameter encoder dan image-encoder yang ditentukan.

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)

Parameter

filename
String

String yang berisi nama file untuk menyimpan ini Image.

encoder
ImageCodecInfo

ImageCodecInfo untuk iniImage.

encoderParams
EncoderParameters

Untuk EncoderParameters digunakan untuk ini Image.

Pengecualian

ArgumentNullException

filename atau encoder adalah null.

ExternalException

Gambar disimpan dengan format gambar yang salah.

-atau-

Gambar disimpan ke file yang sama dengan tempat gambar dibuat.

Contoh

Contoh berikut membuat Bitmap objek dari file BMP. Kode menyimpan bitmap ke tiga file JPEG, masing-masing dengan tingkat kualitas yang berbeda.

#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

Keterangan

Menyimpan gambar ke file yang sama dengan yang dibangunnya tidak diizinkan dan melemparkan pengecualian.

Lihat juga

Berlaku untuk

Save(Stream, ImageCodecInfo, EncoderParameters)

Sumber:
Image.cs
Sumber:
Image.cs
Sumber:
Image.cs

Menyimpan gambar ini ke aliran yang ditentukan, dengan parameter encoder dan encoder gambar yang ditentukan.

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)

Parameter

stream
Stream

Tempat Stream gambar akan disimpan.

encoder
ImageCodecInfo

ImageCodecInfo untuk iniImage.

encoderParams
EncoderParameters

EncoderParameters Yang menentukan parameter yang digunakan oleh encoder gambar.

Pengecualian

ArgumentNullException

streamadalah null.

ExternalException

Gambar disimpan dengan format gambar yang salah.

Keterangan

Jangan menyimpan gambar ke aliran yang sama yang digunakan untuk membuat gambar. Melakukannya dapat merusak aliran.

Gambar harus disimpan ke aliran pada offset nol. Jika ada data tambahan yang telah ditulis ke aliran sebelum menyimpan gambar, data gambar di aliran akan rusak.

Berlaku untuk

Save(String, ImageFormat)

Sumber:
Image.cs
Sumber:
Image.cs
Sumber:
Image.cs

Simpan ini Image ke file yang ditentukan dalam format yang ditentukan.

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)

Parameter

filename
String

String yang berisi nama file untuk menyimpan ini Image.

format
ImageFormat

ImageFormat untuk iniImage.

Pengecualian

ArgumentNullException

filename atau format adalah null.

ExternalException

Gambar disimpan dengan format gambar yang salah.

-atau-

Gambar disimpan ke file yang sama dengan tempat gambar dibuat.

Contoh

Contoh kode berikut menunjukkan cara membuat bitmap dari jenis , dan cara menggunakan Save metode . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows. Menangani peristiwa formulir Paint , dan memanggil ConstructFromResourceSaveAsGif metode , meneruskan e sebagai 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

Berlaku untuk

Save(Stream, ImageFormat)

Sumber:
Image.cs
Sumber:
Image.cs
Sumber:
Image.cs

Menyimpan gambar ini ke aliran yang ditentukan dalam format yang ditentukan.

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)

Parameter

stream
Stream

Tempat Stream gambar akan disimpan.

format
ImageFormat

Yang ImageFormat menentukan format gambar yang disimpan.

Pengecualian

ArgumentNullException

stream atau format adalah null.

ExternalException

Gambar disimpan dengan format gambar yang salah.

Keterangan

Anda harus menghindari menyimpan gambar ke aliran yang sama yang digunakan untuk membangunnya. Melakukannya dapat merusak aliran.

Gambar harus disimpan ke aliran pada offset nol. Jika ada data tambahan yang telah ditulis ke aliran sebelum menyimpan gambar, data gambar di aliran akan rusak.

Berlaku untuk

Save(String)

Sumber:
Image.cs
Sumber:
Image.cs
Sumber:
Image.cs

Menyimpan ini Image ke file atau aliran yang ditentukan.

public:
 void Save(System::String ^ filename);
public void Save (string filename);
member this.Save : string -> unit
Public Sub Save (filename As String)

Parameter

filename
String

String yang berisi nama file untuk menyimpan ini Image.

Pengecualian

ArgumentNullException

filenameadalah null.

ExternalException

Gambar disimpan dengan format gambar yang salah.

-atau-

Gambar disimpan ke file yang sama dengan tempat gambar dibuat.

Contoh

Contoh kode berikut menunjukkan cara memanggil Save metode . Contoh ini dirancang untuk digunakan dengan Formulir Windows. Create formulir yang berisi tombol bernama Button5. Tempelkan kode ke dalam formulir, dan kaitkan metode dengan peristiwa tombol 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

Keterangan

Jika tidak ada encoder untuk format file gambar, encoder Portable Network Graphics (PNG) digunakan. Saat Anda menggunakan Save metode untuk menyimpan gambar grafis sebagai file Windows Metafile Format (WMF) atau Enhanced Metafile Format (EMF), file yang dihasilkan disimpan sebagai file Portable Network Graphics (PNG). Perilaku ini terjadi karena komponen GDI+ dari .NET Framework tidak memiliki encoder yang dapat Anda gunakan untuk menyimpan file sebagai file .wmf atau .emf.

Menyimpan gambar ke file yang sama dengan yang dibangunnya tidak diizinkan dan melemparkan pengecualian.

Berlaku untuk