Image.FromFile メソッド

定義

指定したファイルから Image を作成します。

オーバーロード

FromFile(String)

指定したファイルから Image を作成します。

FromFile(String, Boolean)

そのファイルの埋め込み色管理情報を使用して、指定したファイルから Image を作成します。

FromFile(String)

指定したファイルから Image を作成します。

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 の作成元となるファイルの名前が含まれている文字列。

戻り値

Image

このメソッドが作成する Image

例外

ファイルのイメージ形式が有効ではありません。

  • または -

GDI+ は、ファイルのピクセル形式をサポートしていません。

指定したファイルが存在しません。

filenameUri です。

メソッドとメソッドの使用方法を次のコード例に示し FromFile GetPropertyItem SetPropertyItem ます。 この例は、Windows フォームと共に使用するように設計されています。 この例を実行するには、フォームに貼り付け、 Paint としてを渡して、メソッドを呼び出してフォームのイベントを処理し DemonstratePropertyItem e 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

注釈

Managed GDI+ には、次のファイルの種類をサポートする組み込みのエンコーダーとデコーダーがあります。

  • BMP

  • GIF

  • JPEG

  • PNG

  • TIFF

が破棄されるまで、ファイルはロックされたままに Image なります。

ファイルのイメージ形式が有効でない場合、または GDI+ がファイルのピクセル形式をサポートしていない場合、このメソッドは例外をスロー OutOfMemoryException します。

注意

クラスは、 Image ビットマップのアルファ透明度をサポートしていません。 アルファの透明度を有効にするには、1ピクセルあたり32ビットの PNG 画像を使用します。

こちらもご覧ください

適用対象

FromFile(String, Boolean)

そのファイルの埋め込み色管理情報を使用して、指定したファイルから Image を作成します。

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 の作成元となるファイルの名前が含まれている文字列。

useEmbeddedColorManagement
Boolean

イメージ ファイルに埋め込まれている色管理情報を使用する場合は true に設定されます。それ以外の場合は false に設定されます。

戻り値

Image

このメソッドが作成する Image

例外

ファイルのイメージ形式が有効ではありません。

  • または -

GDI+ は、ファイルのピクセル形式をサポートしていません。

指定したファイルが存在しません。

filenameUri です。

次のコード例は、メソッドを使用して新しいビットマップを取得する方法を示して FromFile います。 また、も示して TextureBrush います。

この例は、Windows フォームと共に使用するように設計されています。 という名前のボタンを含むフォームを作成 Button2 します。 フォームにコードを貼り付け、メソッドを Button2_Click ボタンのイベントに関連付け Click ます。

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

注釈

Managed GDI+ には、次のファイルの種類をサポートする組み込みのエンコーダーとデコーダーがあります。

  • BMP

  • GIF

  • JPEG

  • PNG

  • TIFF

ファイルのイメージ形式が有効でない場合、または GDI+ がファイルのピクセル形式をサポートしていない場合、このメソッドは例外をスロー OutOfMemoryException します。

が破棄されるまで、ファイルはロックされたままに Image なります。

パラメーターは、 useEmbeddedColorManagement 新しいが Image イメージファイルに埋め込まれているカラー管理情報に基づいて色補正を適用するかどうかを指定します。 埋め込み情報には、国際カラーコンソーシアム (ICC) プロファイル、ガンマ値、および最も強い情報が含まれます。

注意

クラスは、 Image ビットマップのアルファ透明度をサポートしていません。 アルファの透明度を有効にするには、1ピクセルあたり32ビットの PNG 画像を使用します。

こちらもご覧ください

適用対象