Image.FromFile 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

從指定的檔案建立 Image 物件。

多載

FromFile(String)	從指定的檔案建立 Image 物件。
FromFile(String, Boolean)	使用指定之檔案中的內嵌色彩管理資訊，從該檔案建立 Image。

FromFile(String)

來源:

Image.cs

從指定的檔案建立 Image 物件。

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

參數

filename

String

字串，包含從其中建立 Image 之檔案的名稱。

傳回

Image

這個方法建立的 Image。

例外狀況

OutOfMemoryException

檔案沒有有效的影像格式。

-或-

GDI+ 不支援檔案的像素格式。

FileNotFoundException

指定的檔案不存在。

ArgumentException

filename 為 Uri。

範例

下列程式代碼範例示範如何使用 FromFileGetPropertyItem 和 SetPropertyItem 方法。 此範例的設計目的是要與 Windows Forms 搭配使用。 若要執行此範例，請將它貼到表單中，並藉由呼叫 DemonstratePropertyItem 方法來處理表單的事件Paint，並傳遞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);
}

備註

Managed GDI+ 具有支援下列檔案類型的內建編碼器和譯碼器：

• BMP

• GIF

• JPEG

• PNG

• TIFF

檔案會保持鎖定狀態， Image 直到處置 為止。

如果檔案沒有有效的影像格式，或 GDI+ 不支援檔案的圖元格式，這個方法會 OutOfMemoryException 擲回例外狀況。

注意

類別 Image 不支援位圖中的Alpha透明度。 若要啟用 Alpha 透明度，請使用每個圖元 32 位的 PNG 影像。

另請參閱

• 點陣圖類型

FromFile(String, Boolean)

來源:

Image.cs

使用指定之檔案中的內嵌色彩管理資訊，從該檔案建立 Image。

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

參數

filename

String

字串，包含從其中建立 Image 之檔案的名稱。

useEmbeddedColorManagement

Boolean

若要使用內嵌在影像檔的色彩管理資訊，則設定為 true，否則為 false。

傳回

Image

這個方法建立的 Image。

例外狀況

OutOfMemoryException

檔案沒有有效的影像格式。

-或-

GDI+ 不支援檔案的像素格式。

FileNotFoundException

指定的檔案不存在。

ArgumentException

filename 為 Uri。

範例

下列程式代碼範例示範如何使用 方法來取得新的點陣圖 FromFile 。 它也會示範 TextureBrush。

此範例的設計目的是要與 Windows Forms 搭配使用。 Create 表單，其中包含名為Button2的按鈕。 將程式代碼貼到表單中，並將方法與按鈕的事件Click產生關聯Button2_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.");
    }
}

備註

Managed GDI+ 具有支援下列檔案類型的內建編碼器和譯碼器：

• BMP

• GIF

• JPEG

• PNG

• TIFF

如果檔案沒有有效的影像格式，或 GDI+ 不支援檔案的圖元格式，這個方法會 OutOfMemoryException 擲回例外狀況。

檔案會保持鎖定狀態， Image 直到處置 為止。

參數 useEmbeddedColorManagement 會根據內嵌在影像檔中的色彩管理資訊，指定新的 Image 是否套用色彩校正。 內嵌資訊可能包括國際色彩聯盟 () 配置檔、gamma 值和色度資訊。

注意

類別 Image 不支援位圖中的Alpha透明度。 若要啟用 Alpha 透明度，請使用每個圖元 32 位的 PNG 影像。

另請參閱

• 點陣圖類型