Image.FromFile Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Crée un Image à partir du fichier spécifié.

Surcharges

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

FromFile(String)

Source:

Image.cs

Crée un Image à partir du fichier spécifié.

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

Paramètres

filename

String

Chaîne qui contient le nom du fichier à partir duquel créer Image.

Retours

Image

Image créé par cette méthode.

Exceptions

OutOfMemoryException

Le format d'image du fichier n'est pas valide.

- ou -

GDI+ ne prend pas en charge le format de pixel du fichier.

FileNotFoundException

Le fichier spécifié n'existe pas.

ArgumentException

filename est Uri.

Exemples

L’exemple de code suivant montre comment utiliser les FromFileGetPropertyItem méthodes et SetPropertyItem . Cet exemple est conçu pour être utilisé avec Windows Forms. Pour exécuter cet exemple, collez-le dans un formulaire et gérez l’événement du Paint formulaire en appelant la DemonstratePropertyItem méthode , en passant e comme 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

Remarques

Managed GDI+ dispose d’encodeurs et de décodeurs intégrés qui prennent en charge les types de fichiers suivants :

• BMP

• GIF

• JPEG

• PNG

• TIFF

Le fichier reste verrouillé jusqu’à ce que le Image soit supprimé.

Si le fichier n’a pas de format d’image valide ou si GDI+ ne prend pas en charge le format de pixels du fichier, cette méthode lève une OutOfMemoryException exception.

Notes

La Image classe ne prend pas en charge la transparence alpha dans les bitmaps. Pour activer la transparence alpha, utilisez des images PNG avec 32 bits par pixel.

Voir aussi

• Types de bitmaps

FromFile(String, Boolean)

Source:

Image.cs

Crée un Image à partir du fichier spécifié, en utilisant les informations de gestion de couleurs incorporées dans ce fichier.

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

Paramètres

filename

String

Chaîne qui contient le nom du fichier à partir duquel créer Image.

useEmbeddedColorManagement

Boolean

true pour utiliser les informations de gestion de couleurs incorporées dans le fichier image ; sinon, false.

Retours

Image

Image créé par cette méthode.

Exceptions

OutOfMemoryException

Le format d'image du fichier n'est pas valide.

- ou -

GDI+ ne prend pas en charge le format de pixel du fichier.

FileNotFoundException

Le fichier spécifié n'existe pas.

ArgumentException

filename est Uri.

Exemples

L’exemple de code suivant montre comment obtenir une nouvelle bitmap à l’aide de la FromFile méthode . Il illustre également un TextureBrush.

Cet exemple est conçu pour être utilisé avec Windows Forms. Create un formulaire contenant un bouton nommé Button2. Collez le code dans le formulaire et associez la Button2_Click méthode à l’événement du Click bouton.

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

Remarques

Managed GDI+ dispose d’encodeurs et de décodeurs intégrés qui prennent en charge les types de fichiers suivants :

• BMP

• GIF

• JPEG

• PNG

• TIFF

Si le fichier n’a pas de format d’image valide ou si GDI+ ne prend pas en charge le format de pixels du fichier, cette méthode lève une OutOfMemoryException exception.

Le fichier reste verrouillé jusqu’à ce que le Image soit supprimé.

Le useEmbeddedColorManagement paramètre spécifie si le nouveau Image applique la correction des couleurs en fonction des informations de gestion des couleurs incorporées dans le fichier image. Les informations incorporées peuvent inclure des profils ICC (International Color Consortium), des valeurs gamma et des informations de chromaticité.

Notes

La Image classe ne prend pas en charge la transparence alpha dans les bitmaps. Pour activer la transparence alpha, utilisez des images PNG avec 32 bits par pixel.

Voir aussi

• Types de bitmaps