Image.FromFile Method

Definition

Crée un Image à partir du fichier spécifié.Creates an Image from the specified file.

Overloads

FromFile(String)

Crée un Image à partir du fichier spécifié.Creates an Image from the specified file.

FromFile(String, Boolean)

Crée un Image à partir du fichier spécifié, en utilisant les informations de gestion de couleurs incorporées dans ce fichier.Creates an Image from the specified file using embedded color management information in that file.

FromFile(String)

Crée un Image à partir du fichier spécifié.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

Parameters

filename
String

Chaîne qui contient le nom du fichier à partir duquel créer Image.A string that contains the name of the file from which to create the Image.

Returns

Image

Image créé par cette méthode.The Image this method creates.

Exceptions

Le format d'image du fichier n'est pas valide.The file does not have a valid image format.

-ou--or- GDI+GDI+ ne prend pas en charge le format de pixel du fichier.does not support the pixel format of the file.

Le fichier spécifié n'existe pas.The specified file does not exist.

filename est Uri.filename is a Uri.

Examples

L’exemple de code suivant montre comment utiliser les méthodes FromFileGetPropertyItem et SetPropertyItem.The following code example demonstrates how to use the FromFileGetPropertyItem and SetPropertyItem methods. Cet exemple est conçu pour être utilisé avec Windows Forms.This example is designed to be used with Windows Forms. Pour exécuter cet exemple, collez-le dans un formulaire et gérez l’événement Paint du formulaire en appelant la méthode DemonstratePropertyItem, en passant e en tant que 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

Remarks

Managed GDI+ intègre des encodeurs et des décodeurs intégrés qui prennent en charge les types de fichiers suivants :Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

Le fichier reste verrouillé jusqu’à ce que le Image soit supprimé.The file remains locked until the Image is disposed.

Si le fichier n’a pas un format d’image valide ou si GDI+GDI+ ne prend pas en charge le format de pixel du fichier, cette méthode lève une exception 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.

Note

La classe Image ne prend pas en charge la transparence alpha dans les bitmaps.The Image class does not support alpha transparency in bitmaps. Pour activer la transparence alpha, utilisez des images PNG avec 32 bits par pixel.To enable alpha transparency, use PNG images with 32 bits per pixel.

See also

FromFile(String, Boolean)

Crée un Image à partir du fichier spécifié, en utilisant les informations de gestion de couleurs incorporées dans ce fichier.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

Parameters

filename
String

Chaîne qui contient le nom du fichier à partir duquel créer Image.A string that contains the name of the file from which to create the Image.

useEmbeddedColorManagement
Boolean

true pour utiliser les informations de gestion de couleurs incorporées dans le fichier image ; sinon, false.Set to true to use color management information embedded in the image file; otherwise, false.

Returns

Image

Image créé par cette méthode.The Image this method creates.

Exceptions

Le format d'image du fichier n'est pas valide.The file does not have a valid image format.

-ou--or- GDI+GDI+ ne prend pas en charge le format de pixel du fichier.does not support the pixel format of the file.

Le fichier spécifié n'existe pas.The specified file does not exist.

filename est Uri.filename is a Uri.

Examples

L’exemple de code suivant montre comment obtenir une nouvelle image bitmap à l’aide de la méthode FromFile.The following code example demonstrates how to obtain a new bitmap using the FromFile method. Il illustre également une TextureBrush.It also demonstrates a TextureBrush.

Cet exemple est conçu pour être utilisé avec Windows Forms.This example is designed to be used with Windows Forms. Créez un formulaire contenant un bouton nommé Button2.Create a form containing a button named Button2. Collez le code dans le formulaire et associez la méthode Button2_Click à l’événement Click du bouton.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

Remarks

Managed GDI+ intègre des encodeurs et des décodeurs intégrés qui prennent en charge les types de fichiers suivants :Managed GDI+ has built-in encoders and decoders that support the following file types:

  • BMPBMP

  • GIFGIF

  • JPEGJPEG

  • PNGPNG

  • TIFFTIFF

Si le fichier n’a pas un format d’image valide ou si GDI+GDI+ ne prend pas en charge le format de pixel du fichier, cette méthode lève une exception 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.

Le fichier reste verrouillé jusqu’à ce que le Image soit supprimé.The file remains locked until the Image is disposed.

Le paramètre useEmbeddedColorManagement spécifie si la nouvelle Image applique la correction des couleurs en fonction des informations de gestion de couleurs incorporées dans le fichier image.The useEmbeddedColorManagement parameter specifies whether the new Image applies color correction according to color management information that is embedded in the image file. Les informations incorporées peuvent inclure des profils ICC (International Color Consortium), des valeurs gamma et des informations chromatiques.Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information.

Note

La classe Image ne prend pas en charge la transparence alpha dans les bitmaps.The Image class does not support alpha transparency in bitmaps. Pour activer la transparence alpha, utilisez des images PNG avec 32 bits par pixel.To enable alpha transparency, use PNG images with 32 bits per pixel.

See also

Applies to