Image.FromFile Méthode

Définition

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

Surcharges

Nom Description
FromFile(String)

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

FromFile(String, Boolean)

Crée un Image fichier à partir du fichier spécifié à l’aide d’informations de gestion des couleurs incorporées dans ce fichier.

FromFile(String)

Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
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 le Image.

Retours

Cette Image méthode crée.

Exceptions

Le fichier n’a pas de format d’image valide.

- ou -

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

Le fichier spécifié n'existe pas.

filename est un Uri.

Exemples

L’exemple de code suivant montre comment utiliser les méthodes et FromFile les GetPropertyItemSetPropertyItem méthodes. 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 en tant que 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+ a des encodeurs et des 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 fichier soit supprimé.

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

Note

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

Voir aussi

S’applique à

FromFile(String, Boolean)

Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs
Source:
Image.cs

Crée un Image fichier à partir du fichier spécifié à l’aide d’informations de gestion des 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 le Image.

useEmbeddedColorManagement
Boolean

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

Retours

Cette Image méthode crée.

Exceptions

Le fichier n’a pas de format d’image valide.

- ou -

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

Le fichier spécifié n'existe pas.

filename est un 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. Créez 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+ a des encodeurs et des 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 pixel du fichier, cette méthode lève une OutOfMemoryException exception.

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

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

Note

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

Voir aussi

S’applique à