Image.FromFile

.NET Framework クラス ライブラリ リファレンス

Image.FromFile メソッド (String, Boolean)

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

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Shared Function FromFile
 ( _
    filename As String, _
    useEmbeddedColorManagement As Boolean _
) As Image

Visual Basic (使用法)

Dim filename As String
Dim useEmbeddedColorManagement As Boolean
Dim returnValue As Image

returnValue = Image.FromFile(filename, useEmbeddedColorManagement)

C#

public static Image FromFile (
    string filename,
    bool useEmbeddedColorManagement
)

C++

public:
static Image^ FromFile (
    String^ filename, 
    bool useEmbeddedColorManagement
)

J#

public static Image FromFile (
    String filename, 
    boolean useEmbeddedColorManagement
)

JScript

public static function FromFile
 (
    filename : String, 
    useEmbeddedColorManagement : boolean
) : Image

パラメータ

filename

Image の作成元となるファイルの名前が含まれている文字列。

useEmbeddedColorManagement

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

戻り値
このメソッドが作成する Image。

例外

例外の種類	条件
OutOfMemoryException	ファイルのイメージ形式が有効ではありません。 または ファイルのピクセル形式が GDI+ でサポートされていません。
FileNotFoundException	指定したファイルが存在しません。

解説

このファイルは Image が破棄されるまでロックされます。

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

useEmbeddedColorManagement パラメータは、イメージ ファイルに埋め込まれた色管理情報に従って、新しい Image に色補正を適用させるかどうかを指定します。埋め込み情報には、ICC (International Color Consortium) プロファイル、ガンマ値、および色度情報を含めることができます。

使用例

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

この例は、Windows フォームでの使用を意図してデザインされています。Button2 という名前のボタンを格納するフォームを作成します。コードをフォームに貼り付け、Button2_Click メソッドをボタンの Click イベントに関連付けます。

Visual Basic

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

C#

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.");
    }

}

C++

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." );
      }
   }

J#

private void button2_Click(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.set_WrapMode(System.Drawing.Drawing2D.WrapMode.Tile);

        Graphics formGraphics = this.CreateGraphics();

        formGraphics.FillEllipse(texture, new RectangleF(90, 110,
 100,100));
        formGraphics.Dispose();
    }
    catch (System.IO.FileNotFoundException exp) {
        MessageBox.Show(("There was an error opening the bitmap."  
            + "Please check the path."));
    }
} //button2_Click

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Image クラス
Image メンバ
System.Drawing 名前空間
その他の技術情報
ビットマップの種類

Image.FromFile メソッド (String)

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

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Shared Function FromFile
 ( _
    filename As String _
) As Image

Visual Basic (使用法)

Dim filename As String
Dim returnValue As Image

returnValue = Image.FromFile(filename)

C#

public static Image FromFile (
    string filename
)

C++

public:
static Image^ FromFile (
    String^ filename
)

J#

public static Image FromFile (
    String filename
)

JScript

public static function FromFile
 (
    filename : String
) : Image

パラメータ

filename

Image の作成元となるファイルの名前が含まれている文字列。

戻り値
このメソッドが作成する Image。

例外

例外の種類	条件
OutOfMemoryException	ファイルのイメージ形式が有効ではありません。 または ファイルのピクセル形式が GDI+ でサポートされていません。
FileNotFoundException	指定したファイルが存在しません。

解説

このファイルは Image が破棄されるまでロックされます。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Image クラス
Image メンバ
System.Drawing 名前空間
その他の技術情報
ビットマップの種類

Image.FromFile メソッド

指定したファイルから Image を作成します。
オーバーロードの一覧

名前	説明
Image.FromFile (String)	指定したファイルから Image を作成します。
Image.FromFile (String, Boolean)	そのファイルの埋め込み色管理情報を使用して、指定したファイルから Image を作成します。

参照

関連項目

Image クラス
Image メンバ
System.Drawing 名前空間

その他の技術情報

ビットマップの種類