Image.FromFile 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

从指定的文件创建 Image。

重载

FromFile(String)	从指定的文件创建 Image。
FromFile(String, Boolean)	使用该文件中的嵌入颜色管理信息，从指定的文件创建 Image。

FromFile(String)

Source:

Image.cs

从指定的文件创建 Image。

C#

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

参数

filename

String

字符串，包含要从中创建 Image 的文件的名称。

返回

Image

此方法创建的 Image。

例外

OutOfMemoryException

该文件没有有效的图像格式。

- 或 -

GDI+ 不支持文件的像素格式。

FileNotFoundException

指定的文件不存在。

ArgumentException

filename 为 Uri。

示例

下面的代码示例演示如何使用 FromFileGetPropertyItem 和 SetPropertyItem 方法。 此示例旨在与 Windows 窗体 一起使用。 若要运行此示例，请将其粘贴到窗体中，并通过调用 DemonstratePropertyItem 方法处理窗体的事件Paint，并将其ePaintEventArgs作为 传递。

C#

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 不支持位图中的 alpha 透明度。 若要启用 alpha 透明度，请使用每像素 32 位的 PNG 图像。

另请参阅

• 位图类型

FromFile(String, Boolean)

Source:

Image.cs

使用该文件中的嵌入颜色管理信息，从指定的文件创建 Image。

C#

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 窗体 一起使用。 Create包含名为 的按钮的Button2窗体。 将代码粘贴到窗体中，并将 Button2_Click 方法与按钮的事件 Click 相关联。

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

注解

托管 GDI+ 具有支持以下文件类型的内置编码器和解码器：

• BMP

• GIF

• JPEG

• PNG

• TIFF

如果文件没有有效的图像格式，或者 GDI+ 不支持文件的像素格式，此方法将 OutOfMemoryException 引发异常。

在释放 之前， Image 文件将保持锁定状态。

参数 useEmbeddedColorManagement 指定新 Image 是否根据嵌入在图像文件中的颜色管理信息应用颜色更正。 嵌入的信息可以包括国际颜色联盟 (ICC) 配置文件、伽玛值和色度信息。

备注

类 Image 不支持位图中的 alpha 透明度。 若要启用 alpha 透明度，请使用每像素 32 位的 PNG 图像。

另请参阅

• 位图类型