Image.Save Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Drawing

Zestaw:: System.Drawing.Common.dll

Zestaw:: System.Drawing.dll

Pakiet:: System.Drawing.Common v6.0.0

Pakiet:: System.Drawing.Common v7.0.0

Pakiet:: System.Drawing.Common v8.0.0

Pakiet:: System.Drawing.Common v9.0.0-preview.2.24128.3

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapisuje ten obraz w określonym strumieniu w określonym formacie.

Przeciążenia

Save(String, ImageCodecInfo, EncoderParameters)	Zapisuje to Image w określonym pliku z określonymi parametrami kodera i kodera obrazu.
Save(Stream, ImageCodecInfo, EncoderParameters)	Zapisuje ten obraz w określonym strumieniu z określonymi parametrami kodera i kodera obrazu.
Save(String, ImageFormat)	Zapisuje to Image w określonym pliku w określonym formacie.
Save(Stream, ImageFormat)	Zapisuje ten obraz w określonym strumieniu w określonym formacie.
Save(String)	Zapisuje to Image w określonym pliku lub strumieniu.

Save(String, ImageCodecInfo, EncoderParameters)

Źródło:: Image.cs

Źródło:: Image.cs

Źródło:: Image.cs

Zapisuje to Image w określonym pliku z określonymi parametrami kodera i kodera obrazu.

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)

Parametry

filename: String

Ciąg zawierający nazwę pliku, do którego ma być zapisany plik Image.

encoder: ImageCodecInfo

Element ImageCodecInfo dla tego Image.

encoderParams: EncoderParameters

Element EncoderParameters do użycia dla tego elementu Image.

Wyjątki

ArgumentNullException

filename lub encoder to null.

ExternalException

Obraz został zapisany w niewłaściwym formacie obrazu.

-lub-

Obraz został zapisany w tym samym pliku, na podstawie którego został utworzony.

Przykłady

Poniższy przykład tworzy Bitmap obiekt z pliku BMP. Kod zapisuje mapę bitową w trzech plikach JPEG, z których każdy ma inny poziom jakości.

#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

Uwagi

Zapisanie obrazu w tym samym pliku, z którego został utworzony, jest niedozwolone i zgłasza wyjątek.

Zobacz też

Instrukcje: Ustawianie poziomu dekompresji JPEG

Dotyczy

Save(Stream, ImageCodecInfo, EncoderParameters)

Źródło:: Image.cs

Źródło:: Image.cs

Źródło:: Image.cs

Zapisuje ten obraz w określonym strumieniu z określonymi parametrami kodera i kodera obrazu.

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)

Parametry

stream: Stream

Miejsce Stream , w którym zostanie zapisany obraz.

encoder: ImageCodecInfo

Element ImageCodecInfo dla tego Image.

encoderParams: EncoderParameters

Element EncoderParameters określający parametry używane przez koder obrazu.

Wyjątki

ArgumentNullException

stream to null.

ExternalException

Obraz został zapisany w niewłaściwym formacie obrazu.

Uwagi

Nie należy zapisywać obrazu w tym samym strumieniu, który został użyty do skonstruowania obrazu. Może to spowodować uszkodzenie strumienia.

Obraz musi zostać zapisany w strumieniu z przesunięciem zera. Jeśli jakiekolwiek dodatkowe dane zostały zapisane w strumieniu przed zapisaniem obrazu, dane obrazu w strumieniu zostaną uszkodzone.

Dotyczy

Save(String, ImageFormat)

Źródło:: Image.cs

Źródło:: Image.cs

Źródło:: Image.cs

Zapisuje to Image w określonym pliku w określonym formacie.

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)

Parametry

filename: String

Ciąg zawierający nazwę pliku, do którego ma być zapisany plik Image.

format: ImageFormat

Element ImageFormat dla tego Image.

Wyjątki

ArgumentNullException

filename lub format to null.

ExternalException

Obraz został zapisany w niewłaściwym formacie obrazu.

-lub-

Obraz został zapisany w tym samym pliku, na podstawie którego został utworzony.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć mapę bitową z typu i jak używać Save metody . Aby uruchomić ten przykład, wklej kod do formularza systemu Windows. Obsługa zdarzenia formularza Paint i wywoływanie ConstructFromResourceSaveAsGif metody, przekazując e jako 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

Dotyczy

Save(Stream, ImageFormat)

Źródło:: Image.cs

Źródło:: Image.cs

Źródło:: Image.cs

Zapisuje ten obraz w określonym strumieniu w określonym formacie.

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)

Parametry

stream: Stream

Miejsce Stream , w którym zostanie zapisany obraz.

format: ImageFormat

Element ImageFormat określający format zapisanego obrazu.

Wyjątki

ArgumentNullException

stream lub format to null.

ExternalException

Obraz został zapisany w niewłaściwym formacie obrazu.

Uwagi

Należy unikać zapisywania obrazu w tym samym strumieniu, który został użyty do jego skonstruowania. Może to spowodować uszkodzenie strumienia.

Dotyczy

Save(String)

Źródło:: Image.cs

Źródło:: Image.cs

Źródło:: Image.cs

Zapisuje to Image w określonym pliku lub strumieniu.

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

public void Save (string filename);

member this.Save : string -> unit

Public Sub Save (filename As String)

Parametry

filename: String

Ciąg zawierający nazwę pliku, do którego ma być zapisany plik Image.

Wyjątki

ArgumentNullException

filename to null.

ExternalException

Obraz został zapisany w niewłaściwym formacie obrazu.

-lub-

Obraz został zapisany w tym samym pliku, na podstawie którego został utworzony.

Przykłady

W poniższym przykładzie kodu pokazano, jak wywołać metodę Save . Ten przykład jest przeznaczony do użycia z Windows Forms. Twórca formularz zawierający przycisk o nazwie Button5. Wklej kod do formularza i skojarz metodę ze zdarzeniem przycisku 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

Uwagi

Jeśli nie istnieje koder dla formatu pliku obrazu, używany jest koder Portable Network Graphics (PNG). Jeśli używasz Save metody do zapisywania obrazu graficznego jako pliku WMF (Windows Metafile Format) lub Rozszerzonego formatu metapliku (EMF), wynikowy plik jest zapisywany jako plik Portable Network Graphics (PNG). Takie zachowanie występuje, ponieważ składnik GDI+ .NET Framework nie ma kodera, którego można użyć do zapisywania plików jako plików wmf lub .emf.

Zapisanie obrazu w tym samym pliku, z którego został utworzony, jest niedozwolone i zgłasza wyjątek.

Dotyczy

Udostępnij za pośrednictwem

Image.Save Metoda

Definicja

Przeciążenia

Save(String, ImageCodecInfo, EncoderParameters)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Save(Stream, ImageCodecInfo, EncoderParameters)

Parametry

Wyjątki

Uwagi

Dotyczy

Save(String, ImageFormat)

Parametry

Wyjątki

Przykłady

Dotyczy

Save(Stream, ImageFormat)

Parametry

Wyjątki

Uwagi

Dotyczy

Save(String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby