Image.FromFile Метод

Определение

Создает объект Image из указанного файла.Creates an Image from the specified file.

Перегрузки

FromFile(String)

Создает объект Image из указанного файла.Creates an Image from the specified file.

FromFile(String, Boolean)

Создает объект Image из указанного файла, используя внедренную информацию управления цветом из файла.Creates an Image from the specified file using embedded color management information in that file.

FromFile(String)

Создает объект Image из указанного файла.Creates an Image from the specified file.

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.A string that contains the name of the file from which to create the Image.

Возвращаемое значение

Image

Объект Image, создаваемый этим методом.The Image this method creates.

Исключения

Формат файла не является допустимым форматом изображения.The file does not have a valid image format.

-или--or- GDI+GDI+ не поддерживает формат пикселей в файле.does not support the pixel format of the file.

Указанный файл не существует.The specified file does not exist.

filename имеет значение Uri.filename is a Uri.

Примеры

В следующем примере кода показано, как использовать FromFile GetPropertyItem методы и SetPropertyItem .The following code example demonstrates how to use the FromFileGetPropertyItem and SetPropertyItem methods. Этот пример предназначен для использования с Windows Forms.This example is designed to be used with Windows Forms. Чтобы выполнить этот пример, вставьте его в форму и обработайте событие формы, Paint вызвав DemonstratePropertyItem метод, передав его e как PaintEventArgs .To run this example, paste it into a form, and handle the form's Paint event by calling the DemonstratePropertyItem method, passing e as 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

Комментарии

В управляемом GDI+ есть встроенные кодировщики и декодеры, поддерживающие следующие типы файлов:Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

Файл остается заблокированным до тех пор, пока Image не будет удален.The file remains locked until the Image is disposed.

Если файл не имеет допустимого формата изображения или не GDI+GDI+ поддерживает формат пикселей файла, этот метод создает OutOfMemoryException исключение.If the file does not have a valid image format or if GDI+GDI+ does not support the pixel format of the file, this method throws an OutOfMemoryException exception.

Примечание

ImageКласс не поддерживает альфа-прозрачность в точечных рисунках.The Image class does not support alpha transparency in bitmaps. Чтобы включить альфа-прозрачность, используйте изображения PNG с 32 битами на пиксель.To enable alpha transparency, use PNG images with 32 bits per pixel.

См. также раздел

Применяется к

FromFile(String, Boolean)

Создает объект Image из указанного файла, используя внедренную информацию управления цветом из файла.Creates an Image from the specified file using embedded color management information in that file.

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.A string that contains the name of the file from which to create the Image.

useEmbeddedColorManagement
Boolean

Значение true для использования информации управления цветом, внедренной в файл изображения; в противном случае — значение false.Set to true to use color management information embedded in the image file; otherwise, false.

Возвращаемое значение

Image

Объект Image, создаваемый этим методом.The Image this method creates.

Исключения

Формат файла не является допустимым форматом изображения.The file does not have a valid image format.

-или--or- GDI+GDI+ не поддерживает формат пикселей в файле.does not support the pixel format of the file.

Указанный файл не существует.The specified file does not exist.

filename имеет значение Uri.filename is a Uri.

Примеры

В следующем примере кода показано, как получить новое растровое изображение с помощью FromFile метода.The following code example demonstrates how to obtain a new bitmap using the FromFile method. Также демонстрируется TextureBrush .It also demonstrates a TextureBrush.

Этот пример предназначен для использования с Windows Forms.This example is designed to be used with Windows Forms. Создайте форму, содержащую кнопку с именем Button2 .Create a form containing a button named Button2. Вставьте код в форму и свяжите Button2_Click метод с Click событием кнопки.Paste the code into the form and associate the Button2_Click method with the button's Click event.

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

Комментарии

В управляемом GDI+ есть встроенные кодировщики и декодеры, поддерживающие следующие типы файлов:Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

Если файл не имеет допустимого формата изображения или не GDI+GDI+ поддерживает формат пикселей файла, этот метод создает OutOfMemoryException исключение.If the file does not have a valid image format or if GDI+GDI+ does not support the pixel format of the file, this method throws an OutOfMemoryException exception.

Файл остается заблокированным до тех пор, пока Image не будет удален.The file remains locked until the Image is disposed.

useEmbeddedColorManagementПараметр указывает, Image применяет ли новая цветовая коррекция в соответствии с данными управления цветом, внедренными в файл изображения.The useEmbeddedColorManagement parameter specifies whether the new Image applies color correction according to color management information that is embedded in the image file. Внедренная информация может включать профили ICC, значения гаммы и сведения о цветовой палитре.Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information.

Примечание

ImageКласс не поддерживает альфа-прозрачность в точечных рисунках.The Image class does not support alpha transparency in bitmaps. Чтобы включить альфа-прозрачность, используйте изображения PNG с 32 битами на пиксель.To enable alpha transparency, use PNG images with 32 bits per pixel.

См. также раздел

Применяется к