Image.FromFile メソッド

定義

指定したファイルから Image を作成します。Creates an Image from the specified file.

オーバーロード

FromFile(String)

指定したファイルから Image を作成します。Creates an Image from the specified file.

FromFile(String, Boolean)

そのファイルの埋め込み色管理情報を使用して、指定したファイルから Image を作成します。Creates an Image from the specified file using embedded color management information in that file.

FromFile(String)

指定したファイルから Image を作成します。Creates an Image from the specified file.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename);
public static System.Drawing.Image FromFile (string filename);
static member FromFile : string -> System.Drawing.Image
Public Shared Function FromFile (filename As String) As Image

パラメーター

filename
String

Image の作成元となるファイルの名前が含まれている文字列。A string that contains the name of the file from which to create the Image.

戻り値

このメソッドが作成する ImageThe Image this method creates.

例外

ファイルのイメージ形式が有効ではありません。The file does not have a valid image format.

または-or- GDI+GDI+ はファイルのピクセル形式をサポートしません。does not support the pixel format of the file.

指定されたファイルは存在しません。The specified file does not exist.

filenameUri です。filename is a Uri.

次のコード例は、FromFileGetPropertyItem メソッドと SetPropertyItem メソッドを使用する方法を示しています。The following code example demonstrates how to use the FromFileGetPropertyItem and SetPropertyItem methods. この例は、Windows フォームと共に使用するように設計されています。This example is designed to be used with Windows Forms. この例を実行するには、フォームに貼り付け、DemonstratePropertyItem メソッドを呼び出してフォームの Paint イベントを処理し、ePaintEventArgsとして渡します。To run this example, paste it into a form, and handle the form's Paint event by calling the DemonstratePropertyItem method, passing e as PaintEventArgs.

private:
   void DemonstratePropertyItem( PaintEventArgs^ e )
   {
      // Create two images.
      Image^ image1 = Image::FromFile( "c:\\FakePhoto1.jpg" );
      Image^ image2 = Image::FromFile( "c:\\FakePhoto2.jpg" );

      // Get a PropertyItem from image1.
      PropertyItem^ propItem = image1->GetPropertyItem( 20624 );

      // Change the ID of the PropertyItem.
      propItem->Id = 20625;

      // Set the PropertyItem for image2.
      image2->SetPropertyItem( propItem );

      // Draw the image.
      e->Graphics->DrawImage( image2, 20.0F, 20.0F );
   }
private void DemonstratePropertyItem(PaintEventArgs e)
{

    // Create two images.
    Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
    Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");

    // Get a PropertyItem from image1.
    PropertyItem propItem = image1.GetPropertyItem(20624);

    // Change the ID of the PropertyItem.
    propItem.Id = 20625;

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}
Private Sub DemonstratePropertyItem(ByVal e As PaintEventArgs)

    ' Create two images.
    Dim image1 As Image = Image.FromFile("c:\FakePhoto1.jpg")
    Dim image2 As Image = Image.FromFile("c:\FakePhoto2.jpg")

    ' Get a PropertyItem from image1.
    Dim propItem As PropertyItem = image1.GetPropertyItem(20624)

    ' Change the ID of the PropertyItem.
    propItem.Id = 20625

    ' Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem)

    ' Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F)
End Sub

注釈

マネージ GDI + には、次のファイルの種類をサポートする組み込みのエンコーダーとデコーダーがあります。Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

Image が破棄されるまで、ファイルはロックされたままになります。The file remains locked until the Image is disposed.

ファイルのイメージ形式が有効でない場合、または GDI+GDI+ がファイルのピクセル形式をサポートしていない場合、このメソッドは OutOfMemoryException 例外をスローします。If the file does not have a valid image format or if GDI+GDI+ does not support the pixel format of the file, this method throws an OutOfMemoryException exception.

注意

Image クラスは、ビットマップのアルファ透明度をサポートしていません。The Image class does not support alpha transparency in bitmaps. アルファの透明度を有効にするには、1ピクセルあたり32ビットの PNG 画像を使用します。To enable alpha transparency, use PNG images with 32 bits per pixel.

こちらもご覧ください

FromFile(String, Boolean)

そのファイルの埋め込み色管理情報を使用して、指定したファイルから Image を作成します。Creates an Image from the specified file using embedded color management information in that file.

public:
 static System::Drawing::Image ^ FromFile(System::String ^ filename, bool useEmbeddedColorManagement);
public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);
static member FromFile : string * bool -> System.Drawing.Image
Public Shared Function FromFile (filename As String, useEmbeddedColorManagement As Boolean) As Image

パラメーター

filename
String

Image の作成元となるファイルの名前が含まれている文字列。A string that contains the name of the file from which to create the Image.

useEmbeddedColorManagement
Boolean

イメージ ファイルに埋め込まれている色管理情報を使用する場合は true に設定されます。それ以外の場合は false に設定されます。Set to true to use color management information embedded in the image file; otherwise, false.

戻り値

このメソッドが作成する ImageThe Image this method creates.

例外

ファイルのイメージ形式が有効ではありません。The file does not have a valid image format.

または-or- GDI+GDI+ はファイルのピクセル形式をサポートしません。does not support the pixel format of the file.

指定されたファイルは存在しません。The specified file does not exist.

filenameUri です。filename is a Uri.

FromFile メソッドを使用して新しいビットマップを取得する方法を次のコード例に示します。The following code example demonstrates how to obtain a new bitmap using the FromFile method. また、TextureBrushも示しています。It also demonstrates a TextureBrush.

この例は、Windows フォームと共に使用するように設計されています。This example is designed to be used with Windows Forms. Button2という名前のボタンを含むフォームを作成します。Create a form containing a button named Button2. フォームにコードを貼り付け、Button2_Click メソッドをボタンの Click イベントに関連付けます。Paste the code into the form and associate the Button2_Click method with the button's Click event.

private:
   void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\"
         "All Users\\Documents\\My Music\\music.bmp", true ));
         TextureBrush^ texture = gcnew TextureBrush( image1 );
         texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
         Graphics^ formGraphics = this->CreateGraphics();
         formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
         delete formGraphics;
      }
      catch ( System::IO::FileNotFoundException^ ) 
      {
         MessageBox::Show( "There was an error opening the bitmap."
         "Please check the path." );
      }
   }
private void Button2_Click(System.Object sender, System.EventArgs e)
{
    try
    {
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
        formGraphics.FillEllipse(texture, 
            new RectangleF(90.0F, 110.0F, 100, 100));
        formGraphics.Dispose();
    }
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");
    }
}
Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click
    Try
        Dim image1 As Bitmap = _
            CType(Image.FromFile("C:\Documents and Settings\" _
            & "All Users\Documents\My Music\music.bmp", True), Bitmap)

        Dim texture As New TextureBrush(image1)
        texture.WrapMode = Drawing2D.WrapMode.Tile
        Dim formGraphics As Graphics = Me.CreateGraphics()
        formGraphics.FillEllipse(texture, _
            New RectangleF(90.0F, 110.0F, 100, 100))
        formGraphics.Dispose()

    Catch ex As System.IO.FileNotFoundException
        MessageBox.Show("There was an error opening the bitmap." _
            & "Please check the path.")
    End Try

End Sub

注釈

マネージ GDI + には、次のファイルの種類をサポートする組み込みのエンコーダーとデコーダーがあります。Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

ファイルのイメージ形式が有効でない場合、または GDI+GDI+ がファイルのピクセル形式をサポートしていない場合、このメソッドは OutOfMemoryException 例外をスローします。If the file does not have a valid image format or if GDI+GDI+ does not support the pixel format of the file, this method throws an OutOfMemoryException exception.

Image が破棄されるまで、ファイルはロックされたままになります。The file remains locked until the Image is disposed.

useEmbeddedColorManagement パラメーターは、新しい Image がイメージファイルに埋め込まれているカラー管理情報に基づいて色補正を適用するかどうかを指定します。The useEmbeddedColorManagement parameter specifies whether the new Image applies color correction according to color management information that is embedded in the image file. 埋め込み情報には、国際カラーコンソーシアム (ICC) プロファイル、ガンマ値、および最も強い情報が含まれます。Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information.

注意

Image クラスは、ビットマップのアルファ透明度をサポートしていません。The Image class does not support alpha transparency in bitmaps. アルファの透明度を有効にするには、1ピクセルあたり32ビットの PNG 画像を使用します。To enable alpha transparency, use PNG images with 32 bits per pixel.

こちらもご覧ください

適用対象