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

この Image に使用する EncoderParameters。

例外

ArgumentNullException

filename または encoder が null です。

ExternalException

このイメージは、誤ったイメージ形式で保存されています。

- または -

このイメージは、イメージの作成元と同じファイルに保存されています。

例

次の例では、 Bitmap BMP ファイルからオブジェクトを作成します。このコードでは、ビットマップを 3 つの 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

このイメージは、誤ったイメージ形式で保存されています。

注釈

イメージの構築に使用されたものと同じストリームにイメージを保存しないでください。これにより、ストリームが破損する可能性があります。

イメージは、0 のオフセットでストリームに保存する必要があります。イメージを保存する前にストリームに追加のデータが書き込まれた場合、ストリーム内のイメージデータが破損します。

適用対象

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 フォームに貼り付けます。フォーム 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 フォームで使用するように設計されています。という名前Button5のボタンを含むフォームをCreateします。コードをフォームに貼り付け、メソッドをボタンの 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 メタファイル形式 (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)

パラメーター

例外

例

注釈

適用対象

その他のリソース