英語で読む

次の方法で共有


Image.FromFile メソッド

定義

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

オーバーロード

FromFile(String)

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

FromFile(String, Boolean)

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

FromFile(String)

ソース:
Image.cs
ソース:
Image.cs
ソース:
Image.cs

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

public static System.Drawing.Image FromFile (string filename);

パラメーター

filename
String

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

戻り値

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

例外

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

- または -

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

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

filenameUri です。

次のコード例では、 メソッドと SetPropertyItem メソッドの使用方法をFromFileGetPropertyItem示します。 この例は、Windows フォームで使用するように設計されています。 この例を実行するには、フォームに貼り付け、 メソッドを呼び出して フォームのPaintイベントをDemonstratePropertyItem処理し、 を としてPaintEventArgseします。

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

注釈

マネージド GDI+ には、次のファイルの種類をサポートするエンコーダーとデコーダーが組み込まれています。

  • BMP

  • GIF

  • JPEG

  • PNG

  • TIFF

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

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

注意

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

こちらもご覧ください

適用対象

.NET Framework 4.8.1 およびその他のバージョン
製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

FromFile(String, Boolean)

ソース:
Image.cs
ソース:
Image.cs
ソース:
Image.cs

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

public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);

パラメーター

filename
String

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

useEmbeddedColorManagement
Boolean

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

戻り値

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

例外

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

- または -

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

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

filenameUri です。

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

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

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

注釈

マネージド GDI+ には、次のファイルの種類をサポートするエンコーダーとデコーダーが組み込まれています。

  • BMP

  • GIF

  • JPEG

  • PNG

  • TIFF

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

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

パラメーターは useEmbeddedColorManagement 、イメージ ファイルに埋め込まれている色管理情報に従って、新しい Image が色補正を適用するかどうかを指定します。 埋め込み情報には、国際色コンソーシアム (ICC) プロファイル、ガンマ値、色度情報を含めることができます。

注意

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

こちらもご覧ください

適用対象

.NET Framework 4.8.1 およびその他のバージョン
製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9